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This Manual 



which should be used together with DOS/VS POWER/ VS Logic Part 2, SY33-8577, 
contains information about the internal logic of POWER/VS. To use it effectively, 
the reader should be familiar with the concepts and facihties of POWER/VS as they 
are described in the following IBM DOS/VS manuals: 

Introduction to DOS/VS, GC33-5370 

DOS/VS POWER/VS Installation Guide and Reference, GC33-6048 

DOS/VS POWER/VS Workstation User's Guide, GC33-6049 

RJE,SNA users should also be familiar with the VTAM concepts and facilities as 
they are described in: 

VTAM Concepts and Planning, GC27-6998 
VTAM Macro Language Reference, GC27-6995 

The manual is divided into six sections designed to be used as follows: 



New Readers 



For Program Error Isolation 



( 



SECTION 1 

presents an overview of 

the POWER/VS SCP and 

shows its relationship to 

DOS/VS 




SECTION 6 

contains debugging hints 
and flowcharts which 
recommend a method of 
error analysis 




















1 
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\ 


f 




1 






SECTION 5 

explains the meaning of the 

contents of data areas and 

control blocks required to 

supplement error analysis 

and displays the storage 

layout 




SECTION 4 

provides reference between 
phase and CSECT names 
used and the microfiche 






1 
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SECTION 2 
describes the logical 
functions of the program 



1 



SECTION 3 
refers to DOS/VS 
POWER/VS Logic Part II, 
which contains a detailed 
description of the physical 
program organization 
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Section 1: Introduction 



This section contains an overview of the POWER/ VS System Control Program- It is 
organized as follows : 

P urpose and Functions of PQWER/VS . A general description of POWER/VS and the way its 
major functions are performed under DOS/VS. 

Communication with POWER/VS .' A summary of the POWER/VS Operator Command Language (POOL) 
and the Job Entry Command Language, which allow the user to control POWER/VS operations. 
The format of the messages issued by POWER/VS is also explained. 

Environmental Requirements . This chapter gives a tabular presentation of the programming 
requirements for the various functions of POWER/VS. Then the basic organization of the 
POWER/VS partition is shown, with its storage requirements . A section entitled Hardware 
I Support lists the machines and devices which are supported by POWER/VS. 
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Purpose and Functions of POWER/VS 
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POWER/VS (Priority Output Writers,, Execution Processors and Input Readers/Virtual 
Storage) is a System Control Program which is an automatic spooling processor and 
priority scheduler running under the control of the DOS/VS supervisor. The POWER/VS SCP 
occupies a virtual partition in which it is initiated and can service from one to four 
partitions of a lower dispatching priority. Input to supported partitions is first 
spooled onto intermediate disk storage. When the supported partition commences 
execution,, I/O requests to reader devices are intercepted and satisfied from intermediate 
storage via I/O data areas in the POWER/VS partition. The partition in which the 
POWER/VS SCP is initiated is referred to as the POWER/VS partition. Output requests to 
list and punch devices are also intercepted, with the output being stored in output data 
areas of the POWER/VS partition and later transferred to disk. Printing and punching of 
the output from disk is carried out when requested by the operator. Under the control of 
POWER/VS,, programs may be executed in either real or virtual mode. 

Three major operations are performed under POWER/VS control: 

Read User job information is read from a reader device and spooled to intermediate 

storage (DASD). The PUTSPOOL macro interface can be optionally used to submit a 
job stream from the user's buffer area to intermediate storage. The job is 
executed under the control of the POWER/VS execution processor to meet user 
program requests. 

List List output generated by the user program is spooled to intermediate storage 
(DASD or magnetic tape) before being transferred to a list device, normally a 
line printer, 

Pionch Punch output generated by the user program is spooled to intermediate storage 
(DASD or magnetic tape) before being transferred to a punch device,, normally a 
card punch. The GETSPOOL macro interface can be optionally used to request 
retrieval of printer output. 

Intermediate storage therefore contains user input and output data spooled to and from it 
under the control of POWER/VS. 



POWER/VS SYSTEM VERSIONS 

The user can generate several different versions, depending on the parameters specified 
I in the POWER macro,, and optional PLINE,, PRMT,, and PCPTAB macros. 

The partition in which the POWER/VS SCP is initiated is referred to as the POWER/VS 
partition. 
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Figure 1.1. The major functions of POWER/VS , data flow, and operator communication 
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POWER/VS TASKS 



In order to perform the required operations concurrently, POWER/VS is structured into a 
series of asynchronously executed tasks. All necessary task support is provided within 
the POWER/VS system and does not presuppose Multitasking Support within the DOS/VS 
supervisor. 

M AIN TASK . Initiates and terminates POWER/VS execution and controls the execution of all 
other POWER/VS tasks by means of a private multitasking mechanism. 

COMMAND TASK . Handles all commands submitted by the system operator and initiates and 
terminates other PoWER/VS tasks. 

WAIT TASK .' Transfers the POWER/VS partition to and from the wait state to meet system 
requirements. 

RJE/yBSC LINE MANAGER TASK . Controls all line activities with remote terminals. The task 
is attached when the first line is started and detached when the last line is stopped, 

R JEySNA MANAGER TASK . Controls the activation of transmission processing to and from a 
remote SNA work station on a demand basis. The task is attached when the central 
operator issues a PSTART RJE^SNA command. The SNA manager also attaches a DOS/VS subtask 
in which the interface with the VTAM access method is opened. 

I RJE-,SNA LOGON TASK NO. 1 . Initializes session work areas and does validity checking of 
logon request. 

I RJE,, SNA LOGON TASK NO. 2 . Establishes a session between POWER/VS and a remote SNA work 
Station. 

I RJEfSNA LOGOFF TASK . Terminates a session between POWER/VS and "a remote SNA work 
station. 

RJE,>SNA MESSAGE TASK . Sends messages to a remote SNA work station. 

THE SPOOL MANAGER TASK . Controls the activation and deactiviation of the internal reader 
task and the spool/command manager list task. The task is attached during POWER/VS 
initialization when SPOOL=YES is specified in POWER macro and detached at POWER/VS 
termination. 

READ TASKS . (2) Perform the first part of the read operation and transfer information 
from a peripheral reader to intermediate direct access storage. The operator may call 
for concurrent execution of as many read tasks as he has physical readers available. 
Each read task is therefore associated with a specific reader. 

RJE/BSC READ TASKS . (2) Perform the read operation on an RJE,BSC line. The central 
operator may call for concurrent execution of as many RJE,BSC Read Tasks as he has 
RJE,,BSC lines available. Each RJE,BSC Read Task has the standard name 'RDR' assigned to 
it. Different RJE,BSC Read Tasks are further distinguished by suffixing the line address 
to this standard name. 

RJE, SNA READ TASKS . Perform the read operation from a remote SNA work station. 

INTERNAL READER TASK . Performs the read operation for the PUTSPOOL POWER/VS 
cross* part it ion communication macro interface,. 

EXECUTION READ TASKS . (1) ( 2) Perform the second part of the read operation and transfer 
information from intermediate direct access storage to meet the read requests of the user 
program- The operator may call for concurrent execution of as many execution read tasks 
as he has partitions under POWER/VS control. Each execution read task is therefore 
associated with a specific partition. 
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EXECUTION LIST TASKS . (1> (3) Perform the firSt part of the list function and transfer 
information from the user program to intermediate direct access storage. The operator 
may call for concurrent execution of as many execution list tasks as he has partitions 
under POWER/VS control. Each execution list task is therefore associated with a specific 
partition. 

EXECUTION PUNCH TASKS . (1) (3) Perform the first part of the punch function and transfer 
information from the user program to intermediate direct access storage. The operator 
may call for concurrent execution of as many execution punch tasks as he has partitions 
under POWER/VS control. Each execution punch task is therefore associated with a 
specific partition. 

L IST TASKS . (3) Perform the second part of the list operation and transfer information 
from intermediate direct access storage to the printer. The operator may call for 
concurrent execution of as many list tasks as he has physical printers available. Each 
list task is therefore associated with a specific printer. 

RJE.^BSC LIST TASKS . . (3) Perform the list operation on an RJE, BSC line. Only the remote 
operator may call for concurrent execution of as many RJE,BSC List Tasks as he has 
physical printers available at the terminal,. Each RJE,, BSC List Task has the standard 
name ' LST* assigned to it. Different RJE,BSC List Tasks are further distinguished by 
suffixing the line address and an identifier for the physical printer to this standard 
name. 

RJE,^SNA LIST TASKS . Perform the list operation to a remote SNA work station. 

SPOOL/COMMAND MANAGER LlSl* TASK . Perform the list retrieval (GETSPOOL) and the command 
invokation (CTLSPOOL) for the POWER/VS cross-- partition communication macro interface. 

PUNCH TASKS . (3) Perform the second part of the punch function and transfer information 
from intermediate direct access storage to the punch. The operator may call for 
concurrent execution of as many punch tasks as he has physical punches available. Each 
punch task is therefore associated with a specific punch. 

R JE.BSC PUNCH TASKS . (3) Perform the PUNCH operation on an RJE,BSC line. Only the 
remote operator may call for concurrent execution of as many RJE^BSC Punch Tasks as he 
has physical punches available at the terminal. Each RJE, BSC Punch Task has the standard 
name "PUN* assigned to it. Different RJE^BSC Pionch Tasks are further distinguished by 
suffixing the line address and an identifier for the physical punch to this standard 
name . 

RJE/, SNA PUNCH TASKS . Perform the punch operation to a remote SNA work station. 

ACCOUNT TASK . Supports the POWER/VS job accounting option (together with DOS/VS JAI) . 
It gives the user the option to either save the account file on another medium (tape^ 
disk, cards) or delete the account file. The contents and format of the account records 
are not checked or changed by this task. 

STATUS TASK . The purpose Of this task is to scan the Queue file and print the status 
report on SYSLOG, a line printer,^ or a terminal printer. 

Notes : 

1. Execution Read Tasks, Execution List Tasks, and Execution Punch Tasks are 
collectively referred to as EXECUTION PROCESSOR TASKS. 

^1 2. Read, list and punch tasks are collectively referred to as "read/write" tasks. 

I 3. Each Read Task is divided into two parts, PHYSICAL READER (PR and/or ER) , which 

performs the device-dependent functions related to data collection from a specified 
device or family of devices, and LOGICAL READER (LR) „ which performs the logical 
functions related to entering input data into the POWER/VS Data File and inserting a 
new Queue Entry into the correct position in the POWER/VS Queue File. These two 
parts are linked by means of a high-level logical record interface. 
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I ^. Similarly, each List Task is divided into PHYSICAL LIST (PL),, or PHYSICAL PUNCH (PP),, 
and LOGICAL WRITER (LW) . The physical part of a task performs device dependent 
functions for printer or punch,, respectively* Logical Write retrieves data from the 
List Queue or the Punch Queue, as required. In each case a high-level logical record 
interface is defined to connect the two parts of the task. 

Figure 1.2 shows the relationship of the user program to the POWER/VS partition and tasks 
and to the DOS/VS supervisor. 
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Figure 1.2. Relationship between POWER/VS, DOS/VS,, and the program running under the 
control of POWER/VS 
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POWER/ VS DIRECT ACCESS FILES 

V, .^^ 

Any of the follov?rng direct access devices may be used to contain the POWER/VS files: * 

2314/2319 
3330/3333 

3340 * 

I 3350 

The input stream provided by the user to POWER/VS is broken up into a series of discrete 
jobs,^ each with its own identifying name,, assigned by the user, and sequence rn umber , 
assigned by the POWER/VS system at the time the job enters the system. Each job is 
described by summary records in direct access storage which form a Read Queue Entry. 

The DOS/VS // JOB and /S, statements function as job delimiters if no JECL is used. 
Otherwise, a job is delimited by the JECL * $$ JOB and * $$ EOJ statements. 

List and punch output generated by a program executed under control of POWER/VS is 
similarly described by summary records which form a List Queue Entry and a Punch Queue 
Entry respectively. A program may create multiple List and Punch Queue Entries for a job 
either 

® by using multiple LST/PUN statements (data-driven output segmentation), or 

® by usage of the Segmented Output Feature (count-driven output segmentation),, or 

» by usage of the LFCB macro (program- driven output segmentation) . 

The three types of Queue Entry Record are logically assembled into three corresponding 
queues. The Reader Queue contain? Read Queue Entries; the List Queue contains List Queue \^ y 
Entries; and the Punch Queue contains Pundh Queue Entries. These three queues service 
all of the partitions running under POWER/VS control. 

The Reader Queue is also referred to as the Input Queue; the term Output Queue is also 
used to refer to the List Queue and the Pimch Queue. Like the reader and writer tasks, 
the POWER/VS queues may be referenced as RDR, LST, or PUN. 

A summary of all the POWER/VS Queues is maintained in the form of the POWER/VS Master 
Record on the Queue file. This record provides the POWER/VS System with a 'warm start' 
capability. 

DATA FILE 

Figure 1.1 shows the transfer of program input and output records to and from 
intermediate storage under the control of POWER/VS. Program data spooled to intermediate 
storage constitutes the POWER/VS data file,. 

The user may assign from one to five separate extents of direct access storage to the 
data file,, using logical units SYS002 to SYSOOe within the POWER/VS partition. Each of 
the extents (with the file name IJDFILE) must start on a cylinder boundary and must 
contain an integral number of cylinders. 

Track Group 

The space assigned to the data file is managed by dividing it into units called 'track 

groups'. The track group is the basic organizational unit of the data file,, and consists 

of an integral number of tracks. The track group size may vary from a single track to an 

entire cylinder. An appropriate track group size is calculated by POWER/VS at 

initialization time on the basis of the amount of disk storage made available. However,, 

the size can be specified in the TRACKGP parameter of the POWER macro (refer to DOS/VS 

System Generation ) . "^ ^ 
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Data Block Size 

This is the length of physical records written to the data file. Data block size is 
specified by the DBLK parameter of the POWER macro. The maximum data block size that may 
be specified is 2008 bytes,, and the minimum is 544 bytes (refer to DOS/VS POWER/VS 
Installation GirLde and Reference ,, GC33-6048). If it is omitted or 0„ and a cold start is 
performed, the value assumed is based on the DASD assigned to the POWER/VS data file.. 

A minimum DBLK size of 608 bytes is needed to support the printer device type 3211 which 
needs 592 bytes for the UCB (512 bytes for UCB plus 80 bytes message area) and for 
control information POWER/VS needs 16 bytes. 

Each page,, restricted by the storage management, has 20U8 bytes and is controlled by a 24 
bytes Page Control Block (PCB) and a 8 bytes Buffer Control Word (BCW). The BCW is 
located at the begin and the end of each buffer making a total of 24 + 8 + 8 = 40 control 
bytes. This leaves 2008 bytes and this is the maximum DBLK size. 

QUEUE FILE 

In order to control data spooled on the data file, POWER/VS requires a qu^ue file 
assigned as a separate extent (with the file name IJQFILE) to the logical unit SYSOOl. 
Each record in the file has a length of 152 bytes. The queue file contains two types of 
records; a Master Record (MR) of which there is only one,, and Queue Records (QR) of which 
there can be 1024. 

Queue Records 

The input stream provided by the user to POWER/VS is broken up into a series of discrete 
jobs,, each with its own identifying name,, assigned by the user, and with a sequence 
number, assigned by the POWER/VS system at the time the job enters the system* 

An input job stream^, together with its data, is written to one or more track groups on 
the data file. The seek address of each track group is kept in a queue record on the 
queue file. When a track group becomes full a new queue record is constructed until the 
complete input job has been written on the data file,. 

The collection of queue records thus constructed is called a queue set , and this set<, 
together with its associiated track group (s), constitutes a queue entry . Figure 1.3 
illustrates these relationships. 
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Figure 1.3. Relationship between a Queue Set,, Queue Records,, and a Queue Entry 

The illustration shows a job which required four track groups on the data 
file. 
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ACCOUNT SUPPORT 



If the DOS/VS supervisor has been generated to support the job accounting interface (JAI) 
option, which is to be used by programs under the control of POWER/VS , the following 
three conditions must be fulfilled: 

• JA=YES or JA=(nl,n2,n3,n4,n5) must be specified in the FOP T macro during generation of 
the DOS/VS supervisor. 

• ACCOUNT=YES must be specified in the POWER macro. Bit of the POWER/VS flag byte 
(Partition COMREG, displacement decimal 164 or hexadecimal A4) will be on if POWER/VS 
supports accounting. 

• DLBL and EXTENT statements (with the file name IJAFILE) must be provided,^ and a single 
extent must be assigned to SYSOOO for the POWER/VS account file. 

ACCOUNT FILE 

Accounting information is collected both from the POWER/VS partition and from the DOS/VS 
JAI for partitions under the control of POWER/VS,, and is merged within the Account File 
together with full identifying information. The user need not provide his own data 
collection routine, since POWER/VS collects all the data included in the user portion of 
the job accounting interface table. 

The normal POWER/VS collection of accounting information is used for PUTSPOOL/GETSPOOL 
processing. 

The POWER/VS account file may contain six types of records: 

Read account record -- created for each read queue entry entered into POWER/VS,. 

List account record - created for each list queue entry processed by a list task,. 

Punch account record - created for each punch queue entry processed by a punch task. 

Execution account record- created during program execution on the basis of one record 

per job step. 

Line account record * created for each RJE„BSC user session. When the session is 

terminated, the SIGNOFF processor writes the account record 
to the account file. 

SNA accoijnt record - created for each RJE,SNA user session. When the session is 

terminated, the SNA LOGOFF processor writes the account 
record to the account file. 
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Communication with POWER/VS 



POWER/VS OPERATOR COMMAND LANGUAGE (POCL) 



POWER/VS provides an Operator Command Language (POCL) which allows the central System 
operator and the remote terminal operator to commimicate with the system. Four types of 
command are provided: 

• Task Management Commands allow the operator to initiate and terminate POWER/VS Tasks 
(except spool management tasks). 

Task management commands are only applicable to the RJE writer task. The reader task 
is started by the central operator when he brings up the line,. Its operation is 
controlled by the system. 

• Queue Management Commands allow the operator to display and modify the contents of 
POWER/VS Queue Entries. 

Queue management commands are only applicable to jobs that are submitted by or j^outed 
to the same remote ID as the one issuing the command. 

• List Control Commands allow the operator to perform certain device-dependent 
operations on line printers. 

• Terminal Control Commands allow the remote operator to initiate and terminate POWER/VS 
RJE tasks. 

Figure 1.4 shows the abbreviated and extended command codes available to the central 
operator. Figure 1.5 lists the commands to be used by the remote terminal operator. 
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1 Task 


1 PSTART j 


S [start a task or partition 




j management | PSTOP | 


P 1 stop a task or partition 






IPGO 1 


G [activate a task or partition 






JPEND 1 


1 end POWER/VS execution 






1 PCANCEL 1 


C [cancel POWER/VS status task 






JPFLUSH 1 


F i flush an active job 






1 PRESTART ! 

L ^ L_ 


T [restart a writer task 

X -««.^ — ^ ^ 
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] Queue , 


|PDISPLAY| 


D [ display job status 




1 managemen 


tj PALTER 1 


A (alter attributes 






JPDELETE 1 


L [delete a job or a message 






! PRE LEASE! 


R [release a job 






JPBRDCST 1 


B [ transmit a message 






JPINQUIREI 


I [check terminal status 






JPACCOUNTI 
L J 


J [process account file 
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[List 


1 PSETUP 1 


U [print page layout 




1 control 


! 1 


1 





For further details about these commands,, refer to DOS/VS Operating Procedures . 
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Figure 1.4. Central operator commands 
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I Type 



1 Terminal ] LOGON 

I control JSIGNGN 

j I SIGNOFF 

I I LOGOFF 

I Task 1 START 
I managemen t [ STOP 

I I FLUSH 

I I RESTART 

I I GO 



j C omma nd j P unc t i on 



I start an RJE^SNA user session 

[start an RJE, BSC user session 

I terminate an RJE,BSC or RJE^SNA user session 

[terminate an RJE,, SNA user session 

I start a writer ta^k or message queuing 
[stop a writer task or message queuing 
[ flush an active job 
I restart a writer task 
[reactivate a writer task 






[Queue [DISPLAY 

I management | ALTER 
[ [DELETE 

[ [RELEASE 

1 I BRDCST 



[List [ 

[control [ 
L_« — . -X 



SETUP 



(display job status 

I alter job attributes 

(delete a job or a message 

\ release a job 

j transmit a message 

+^^ .^^^ .^ . « 

[print page layout 
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For further details, refer to DOS/VS Operating Procedure s, 
Figure 1.5. Remote terminal operator commands 

JOB ENTRY CONTROL LANGUAGE (JECL) 



£>OWER/VS provides a JECL to assist the user in delimiting jobs to the system and to allow 
him to specify special requirements that may apply to particular jobs. JECL supplements 
but does not replace the Job Control Language (JCL) provided by DOS/VS itself. The JCL 
statements required for normal DOS/VS system operation are also required when operating 
under POWER/VS. 
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[JECL Statements [Function 



[* $$ CTL 

I 

[* $$ JOB 

I 

I* $$ EOJ 

I 

I* $$ RDR 

I 

[ * $$ LST 
[* $$ PRT 

I 

[ * $$ PUN 

I 

[* $$ SLi 

I 

j* $$/* 

I 

I* $$/fe 

! 

i* $$ DATA 






specifies a default input class 

indicates the beginning of a job and provides handling information 

indicates the end of a job 

inserts a diskette file into the input stream 

provides handling information for printed output 

provides hcindling information for punched output 

inserts data from a sublibrary into the job stream 

indicates the end of a job step (used for the SLi statement only) 

indicates the end of a job (used for the SLI statement only) 

inserts data into a book in a source statement library 



For details refer to D OS/VS System Control Statements . 
Figure 1.6. Job Entory Control Language (JECL) statements 
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FORMAT OF POWER/VS OPERATOR MESSAGES 



Messages sent by the POWER/VS system to SYSLOG,, SYSLST,, or to a terminal may have the 
following formats: 

IQnnI or iRnnI or IVnnI inf or mat ion- type message 
IQnnD decas ion- type message 

IQnnA or IRnnA or IVnnA action-type message 

where : 

Q = POWER/VS message indicator (general) 

R = POWER/VS message indicator (for messages issued by RJE„BSC and command processor 

tasks) 
V = POWER/VS message indicator (for messages issued by RJE^SNA tasks) 
nn = message identification number. 

I-type messages are for the operator's information only; no response is required. 
Processing continues normally. I-type messages for remote terminals are stored in the 
list queue. 

D-type messages require an immediate reply from the operator. The console keyboard is 
unlocked for the operator to reply, and the system waits for the operator's reply. For 
systems running under DOS/VS Release 34 SCP^ the console is not available to the rest of 
the system, and hence, decision-type messages will only be issued in situations where an 
operator decision are absolutely required* This limitation does not apply, however,, for 
users running with DOS/VS Advanced Functions (available as a licensed program). See 
Advanced Functions DOS/VS, General Information manual, GC33-6048. D-type messages are 
never sent to remote terminals. 



A-type messages require some action from the operator, 
terminals are directly displayed on the remote printer, 
put in the wait state. It may be reactivated 



A-type messages for remote 
The task issuing the message is 



• centrally by: 

PGO command. This command is normally entered by the operator after he has taken 
the appropriate action. 

PFLUSH command to discontinue the job. 

• remotely by : 

RESTART command to continue the job. 
- FLUSH command to discontinue the job. 



C 



Most messages contain a task identifier to identify the task issuing the message. For 
reader/writer or RJE tasks, this identifier has the format ttttt, where ttttt stands for 
RDR,, PUN, or LSTn. For execution processors,, the identifier has the format pp„ where pp 
stands for BG or Fn,, where "n" stands for the partition number. 

There are four types of messages: 

• Initialization messages 

• Execution processor and reader /writer task messages 

• Operator command messages 

• Remote (RJE) messages. 

All messages, issued by POWER/VS,, are listed in Section 4. 
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Environmental Requirements 



PROGRAMMING REQUIREMENTS 



V ../ 



Programming Requirements 



During generation of the DOS/VS 
supervijor POWER-YES in SUPVR 
macro forces 

• PHO-YES 
PFIX-YES 
ECPREAL-YES 
andlf NPARTS=1,oris 
not specified, 

• NPARTS=3 

• XECB=4 

For POWER/VS 3800 Support 

• AP=YES 

must be specified in tlie SUPVR 
macro. 



The following phases must be 
cataloged in the CI L: 

IPW$$I1 IPW$$PP 

IPVy$$l2 IPW$$XR 

IPW$$NU IPW$$XW 

IPW$$CP IPW$$XJ 

IPW$$GD IPW$$TR 

IPW$$PD IPW$$LU 

IPW$$AQ IPW$$PS 

IPW$$RQ IPW$$IC 

IPW$$NQ IPW$$SC 

IPW$$DQ IPW$$ER 

IPW$$FQ IPW$$OE 

IPW$$PR IPW$$OT 

IPW$$LR IPW$$AS 

IPW$$PL $$BOWIN 
IPW$$LW 

and the macro POWER must be 
cataloged in the SSL. 



Number of entries in the LUB table 
(in the DOS/VS supervisor), belonging 
to the POWER/VS partition must be 
large enough to accommodate all 
reader and writer tasks that may be 
running concurrently. Programmer 
LUBs SYSOOO thru SYS006 are 
reserved for the account, queue, and 
data files. 



For POWER/VS RJE,BSC 
(optional) 



For POWER/VS RJE,SNA 
(optional) 



The phases IPW$$TM and 
IPW$$MS mi^st also be 
cataloged in the CI L and 
the macros PLINE and 
PRMT must be cataloged 
in the SSL. 



The following phases must 
also be cataloged in the CI L: 
IPW$$IB IPW$$MP 



IPW$$LF 
IPW$$LH 
IPW$$LN 
IPW$$MD 



IPW$$OB 
IPW$$N 
IPW$$OC 
IPW$$VE 



and the macros PLINE and 
PRMT and PCPTAB must be 
cataloged in the SSL. 



I/O Files 

The Queue file and Data file must be 
assigned to a spooling device (see 
Figure 1 .10 for applicable devices). 

Queue file SYS001 thru SYS006 
Data f ile(s) 

as required. 

Queue file and Data file extents must 
be defined on the SYSRES label 
nformation cylinder. 



For POWER/VS Accounting 
(optional) 



The following phases must 
also be cataloged in the CIL: 

IPW$$PA 
IPW$$GA 
IPW$$SA 



JA-YES or n1, n2, n3, n4, n5 
must be specified in the FOPT 
macro during generation of the 
DOS/VS supervisor. 



An Account file must be 
assigned to SYSOOO, a 
spooling device. Account 
file extents must be 
defined on the SYSRES 
label information cylinder. 



FOR POWER/VS Cross- 
Partition Communication 
Support (Optional) 



For POWER/VS SLI Support 
(optional) 



The Phase IPW$$SM must 
also be catalogued in the 
CIL. 

The macros 

• PUTSPOOL 

• GETSPOOL 

• CTLSPOOL 

• SPL 

must be catalogued in the 
SSL. 



The support for POWER/VS 

statement • $$SLI is included, 

whereby source library books 

are inserted into the job 

stream. 

The phase IPW$$SL must be 

cataloqued in the CIL. 



Figure 1,7. Programming requirements for POWER/VS 
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STORAGE REQUIREMENTS AND ALLOCM'IQNS 



Virtual Storage 



The virtual address space of the POWER/VS partition consists of three major areas as 
shown in Figure 1.8.. 



( 





^ 152K; 




^^^-^'' 


Major control blocks and the 
nucleus phase (IPW$$NU) 


POWER^ 


Permanent areiji 
8K 


^^^"^ 




Fixable area 

2K 




Control blocks and data buffers 
used by POWER/VS tasks 


Pageable area 

146K 


^^-: 




Reenterable POWER/VS code 


Page Data Set 


GETVIS area 
(optional) 


(SYSVIS) 








s 

\ 

N 


Control blocks and work areas used 
by RJE,SNA 



Figure 1.8, 



Minimum size of virtual partitiorv (no optional support) = 142K plus size of real partition 

Basic organization of the POWER/VS partition 



• The permanent area, consisting of three pages (8K) , is permanently fixed (PFIXed) in 
the real partition during initialization of POWER/VS. These pages are freed (PFREEed) 
only when POWER/VS is terminated. 

• The fixable area consists of pages that are fixed when a task is started and freed 
when they are no longer reqmred for the completion of this task. 

• The pageable area consists of pages that are allowed to be paged out whenever DOS/VS 
requires additional real storage. 

• The GETVIS area contains control blocks and work areas used by RJE,SNA or 
for printer setup processing. 

Real Storage 

The minimum real address space must be equal to the size of the permanent area (6K) plus 
the fixable area. The size of the fixable area (minimum = 4K) depends on the size of the 
data buffers,, which is determined by the value specified in the DBLK parameter of the 
POWER macro during DOS/VS supervisor generation. (The minimum size of a data buffer = 
544 bytes, and the maximum size = 2008 bytes.) 

For a description of how to calculate POWER/VS storage requirements refer to DOS/VS 
POWER/VS Installation Guide and Reference ,, GC 3 3- 6 04 8,. 
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HARDWA.RE SUPPORTED 

Machine Requirements 

Any Model of System/ 370 supported by DOS/VS* 



V 



Devices Supported 

P ^-. ^ ^i . — ^ . ^ 

[Readers I Printers^ I Punches I Spooling Devices j Terminals] 



I I 



1442 


11403 


11442 


12400 


series'^ ^ 


127703 1 


2501 


11443 


1 2520 


1 3400 


series^ 


|2780 1 


2520 


13203 


12540 


12314/2319 


|3771* 1 


2540 


13211 


|2560 


1 3330/3333 


13773« 1 


2560^ 


13800 


[3525 


13340 




13774* 1 


3504 


15203 


1 5425 


1 3350 




|3775« 1 


3505 


1 


1 


1 




13776- 1 


3525 


! 


1 






137803 1 


3540 


1 


1 


1 




13790^ 1 


5425* 


1 


1 


1 




1 1 


.—-.«.*.—. 


-.ji 




.-.X 







Figure 1.10. Devices supported by POWER/VS 



Notes: 



The IBM 2495 tape cartridge reader does not belong to this series.- 
Only as list and punch output devices.. 

For 7- track tape units the data convert feature is required. 
The following I/O devices are supported by RJE^BSC. 



IBM 54 5 Punch (Model 3 or 4) 
IBM 2213 Printer (Model 1 or 2) 
IBM 250 2 Card Reader (Model Al or A2) 
IBM 2203 Printer (Model Al or A2) 
IBM 3781 Punch on the 3780. 



on the 2770 



Teleprocessing control units supported by RJE^BSC are: 

IBM 2701 Data Adapter Unit with SDA (Type 2) 

IBM 270 3 Transmission Control Unit 

IBM 3704 Communications Adapter in 2703 emulation mode 

IBM 370 5 Communications Adapter in 2703 emulation mode 

Integration Communication Adapter for the Models 115, 125,, and 135-. 

Restrictions: 

• TP connections must be point-to-point on switched or non-switched lines,. 

• Multipoint connections are not supported. 

• Terminals and control units having the multipoint line control or multipoint data 
link control features are prohibited. (Connecting such a terminal or control unit 
to the POWER/RJE,,BSC system will cause continuous error recovery processing.) 



The Universal Character Set Buffer (UCB) and Forms Control Buffer (FCB) features are 
supported by POWER/VS. The execution processor will accept UCB and FCE load requests 
from the various supported partitions for appropriate action at list time. On 
encountering an FCB load command, the execution processor will update the internal 
buffer representation to reflect the new buffer. 
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POWER/VS will support the 2560 and 5425 devices as SYSRDR, SYSIPT,, and SYSPCH, and 
will handle 96 column input and output records for the 5425. The following functions 
are included: 

• Prog ram* controlled stacker selection 

• Punch and interpret 

• Card print 

• Punch and print- 
However,, there are some restrictions: 

• POWER/VS cannot update or interpret a card input file 

• Read column binary is not supported 

• No prog ram-- controlled stacker selection on input. 

• If a 2 56 Punch or 542 5 Punch is used,, then hopper 1 must be used for input. 
Hopper 2 must be used for output,. When no separate cards are used hopper 1 may 
also be used for output. 

The following I/O devices are supported by RJE„SNA,. 

IBM Magnetic Diskette Storage (3774,, 3775,, 3776) 
IBM 2502 Card Reader (3774,, 3775,^ 3776) 
IBM 3501 Card Reader (3771, 3774,, 3775, 3776) 
IBM 3521 Card Punch (3771,, 3774,, 3775,, 3776) 
IBM 3784 Printer (3774) 

POWER/VS does not control SDLC lines. The SNA terminals may be Connected to VTAM and 
the NCP on any communication media supported by VTAM. 

The 3790 support is limited to that comprising the 3790 RJE Facility. 



^f^%,^ 
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Section 2: Method of Operation 



( 



This section describes in general the way in which POWER/VS operates. It outlines the 
logical structure of the POWER/VS SCP,, presenting overviews of all internal operations 
and indicating the relationships between the various tasks and routines. 

The following topics are discussed: 

Code organization explains the POWER/VS code and storage structure and lists the internal 
macros. 

Initialization and Termination gives an overview of the phases that handle start-up and 
shut-down of POWER/VS processing. 

POWER/VS multitasking explains the principles of task selection,^ of starting a task,, and 
of terminating a task. 

Reader, execution processor,, and writer tasks shows the data flow through the spooling 
process, and highlights the work done by the various phases related to these tasks- 
Functions explains the functions involved in the spooling process, and specifically the 
queue and data file processing technique. 

Services describes the routines of the nucleus phase. 

Command processor ^ives an overview of command processing; how the command processor is 
invoked, and what actions are taken. 

POWER/VS job accounting describes the account functions and the save account task. 

Remote job entry highlights the essentials of RJE,BSC and RJE„ SNA. 

Appendages lists the routines in the nucleus phase that are extensions of the DOS/VS 
system control programs. 
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Code Organization 



K ,,^ 



STORAGE STRUCTURE 

The address space of the virtual POWER/VS partition is composed of three major areas,, 
each containing an integral number of pages, 

I The permanent area consists of the first four pages of the POWER/VS virtual address area. 
These are fixed in real storage as soon as the POWER/VS system begins execution, and 
remain fixed till the system is terminated. They contain the nucleus phase, which 
consists of major control tables and routines which do not tolerate paging activity. 
See Figures 5.1 and 5.2. 

The fixable area consists of the second groi:p of pages within the POWER/VS virtual 
address area. These provide the necessary address space for dynamically-structured 
control areas and for data buffers used by the POWER/VS tasks. The size of this area 
depends on the amount of real address space that the user has assigned to the POWER/VS 
partition. The pages within the area are fixed when reserved for specific task use and 
freed when no longer required. At any point in time certain pages within the area will 
be fixed while others are free; the necessary page fixing and freeing is controlled by 
the storage management service of POWER/VS. See Figure 5.3.. 

The pageable area consists of the remaining pages within the POWER/VS virtual address 
area. These contain the remaining phases of the POWER/VS code and may be *paged at any 
time the system requires additional real storage. The size of this area depends on the 
particular POWER/VS phases required for system execution; this in turn depends upon the 
execution options selected by the user (accounting, RJE, reader exit, cross-partition 
spool manager support,, and SLI facility).. 

/' ''"N 

The page frames within real processor storage that are occupied by POWER/VS at any time ; 

are divided into two groups : V >^ 

^ The first group of page frames have been obtained from within the DOS/VS page pool and 
contain pages of code from the POWER/VS pageable area which are currently being 
referenced for instruction execution. Page frames within this group remain part of 
the page pool and are susceptible to system paging. 

® The second group of page frames have been withdrawn from the DOS/VS page pool and 

contain, firstly, the pages of the POWER/VS permanent area and,, secondly,, those pages 
of the POWER/VS fixable area which have been fixed in real storage by the POWER/VS 
storage management service. 

Note 1 ; The pages of the POWER/'VS fixable area which have not been fixed in real storage 
by POWER/VS do not occupy real storage in any sense,. 

I Note 2 : For RJE,SNA operations or for 3800 Printer setup processing the DOS/VS GETVIS 
area in the POWER/VS partition is used to allocate work areas and control blocks. Refer 
to Figure 2.24F for a description of the RJE,SNA control blocks and work areas and to 
Section 5, "Layout of the Storage and Data Areas." The work areas are allocated by the 
SNA processors and freed when no longer needed. In case of 3800 Printer setup 
processing the work area is allocated by the SETPRT logic module and freed when no longer 
needed. 

CODE STRUCTURE 

The code of POWER/VS consists of External Routines,, Internal Routines^ Functions,, 
Services, and Appendages. 

External routines provide task support at the highest level of the system. Each external ^ 
routine consists of a single phase which is physically located in the POWER/VS pageable (, 
area-. \_ r 
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The following external routines are provided: 

IPW$$ER 3540 Diskette Reader 

IPW$$IB RJE,,SNA Inbound Processor 

IPW$$iyiP RJE,SNA Message Processor 

IPW$$LF RJE^SNA Logoff Processor 

IPW$$IH RJE.SNA Lgon Processor No. 1 

IPW$$LN RJE,^SNA Logon Processor No. 2 

IPW$$OB RJE,SNA Outbound Processor 

IPW$$OC Outbound Compaction Manager 

IPW$$PL Physical List 

IPW$$Pt Physical Punch 

IPW$$PR Physical Reader 

IPW$$PS Print Queue Status 

It>W$$SA Save Account 

IPW$$SM Internal Reader Spool Command Manager 

IPW$$SN RJE,,SNA Manager 

IPW$$TM RJE,BSC Routines 

IPW$$VE VTAM Exit Routines 

Internal routines provide task support at a level below external routines, which 
communicate with them by means of the Interface Macro Instrix:tions to be described below. 
Each internal routine consists of a single phase which is physically located in the 
POWER/VS pageable area. 

The following internal routines are provided: 



( 



IPW$$LR Logical Reader 

IPW$$LW Logical Writer 

IPW$$XR Execution Reader 

IPW$$XW Execution Writer. 

Functions provide support for operations common to two or more routines; they are to be 
regarded as high-level subroutines capable of concurrent execution, and are invoked by 
means of the Function Macro Instructions to be described below. Each function consists 
of a single phase which is physically located in the POWER/VS pageable area. 



The following functions are provided: 

IPW$$RQ Reserve Queue Record 

IPW$$AQ Add Queue Set to chain 

IPW$$NQ Get Next Queue Set from chain 

IPW$$DQ Delete Queue Set from chain 

IPW$$FQ Free Queue Set storage 

IPW$$PD Put Data Record 

IPW$$GD Get Data Record 

IPW$$SL Get Source Statement Library Record 

IPW$$PA Put Account Record 

IPW$$GA Get Account Record 

IPW$$IC Invoke Command Processor 

IPW$$SC Scan Reader JECL statement 

IPW$$XJ Scan Execution JECL statement 

IPW$$LU Update LUB and PUB tables 

IPW$$MD Message definition 

IPW$$MS Message Handler 

IPW$$OE 3540 Diskette Open 

IPW$$OT Tape Open. 

IPW$$AS Asynchronous service 

Services provide support for operations common to many routines and functions; they are 
to be regarded as low- level subroutines capable of concurrent execution,, and are invoked 
by means of the Service Macro Instructions to be described below. Each service is coded 
as a separate segment; all of these segments are however physically located within the 
nucleus phase (IPW$$NU) which forms the POWER/VS permanent area. 
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The follcwing services are provided: 



Task Management 
Resoiirce Management 
Storage Management 
Message Service 
Disk and Tape Service 
Timer Service 
Validation Service. 



Appendages provide code which^ though physically present in the nucleus phase (IPW$$N0),, 
is logically part of the DOS/VS supervisor or of some other DOS/VS component. Appendages 
may reference and update POWER/VS tables and data areas but may not invoke any POWER/VS 
routine, function,, or service,, and may not be invoked by them. 



The following appendages are provided: 



Page Fault Appendages 

Attention Interface Appendage 

RJE Channel End Appendage 

Hot Reader Appendage 

SVC Appendage 

SVC 90 and SVC 91 Appendage. 
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( 



( 



IPW$$CP Command Processor 



IPW$$xx - Physical Routines 



SN 

RJE,SNA 
Manager 



PR 

Physical 
Reader 



OB 

RJE^SNA 
Outbound 
Processor 



LH 

RJE,SNA 
Logon 
Processor 1 



PL 

Physical 
List 



OC 

RJE,SNA 

Outbound 

Compaction 

Manager 



LN 

RJE,SNA 
Logon 
Processor 2 



PP 

Physical 
Punch 



LF 

RJE,SNA 
Logoff 
Processor 



TM 
RJE,BSC 



MP 

RJE,SNA 

Message 

Processor 



ER 

3540 

Diskette 

Reader 



IB 

RJE,SNA 

Inbound 

Processor 



SM 

Internal 
Reader 
Spool Com- 
mand Mgr. 



External Routines 



IPW$$PS 
Print 
Queue 
Status 



Interface Macros 



IPW$$SA 

Save 

Account 



Internal Routines 



Execution Processor Routines 



IPW$$XR 
Execution 
Reader 



IPW$$XW 
Execution 
Writer 



Logical Routines 



IPW$$LR 

Logical 

Reader 



IPW$$LW 

Logical 

Writer 



Function Macros 



IPW$$xx - Functions 



RQ 

Reserve 

Queue 

Record 



NO 

Next 

Queue 

Set 



AQ 

Add New 

Queue 

Set 



DO 

Delete 
Queue 
Set 



FQ 

Free 

Queue 

Set 



IC 

Invoke 
Command 
Processor 



PD 

Put 

Data 

Record 



GD 

Get 

Data 

Record 



PA 

Put 

Account 

Record 



GA 

Get 

Account 

Record 



SC 

Scan 

Reader 

JECL 



LU 

Update 

LUB/PUB 

Tables 



SL 

Get 
SSL 
Record 



MS 

Message 
Handler 



OE 

Open 
3540 
Diskette 



XJ 

Scan 

Execution 

JECL 



OT 

Open 
Tape 



AS 

Asynchronous 
Service 



Service Macros 







1 


. 










IPW$$NU - Services 


TMS 

Task 

Management 

Service 


DS 

Disk 
Service 


TS 

Tape 
Service 


VS 

Validation 
Service 


SM 

Storage 

Management 

Service 


RM 

Resource 

Management 

Service 


MS 

Message 
Service 


TIS 

Timer 
Service 



Figure 2.1. Hierarchic organization of calling sequence and interfaces between the 
POWER/VS routines 



Note that appendages and initiator/terminators are not part of this hierarchy. 
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INTERNAL MACRO INSTRUCTIONS 



Cominunication between external routines, internal routines,, functions,, and services is 
performed by means of POWER/VS internal macro instructions (see Figure 2.1). Macro 
instructions are also provided to define the format of common tables and data areas,, and 
to perform other miscellaneous functions,. 



V.„„.„-='^ 



There are five types of POWER/VS internal macro instructions: 

Interface Macros 
Function Macros 
Service Macros 
Definition Macros 
Miscellaneous Macros. 



i Interface Macros 



I Purpose 
.+. ^ .- 

I open logical interface 
I close logical interface 
I put logical record 
I get logical record 



— ^ 



|IPW$OLI 
|IPW$CLI 
I IPW$PLR 
I IPW$GLR 



— J 



(Function Macros 
^^ « 

Queue management 

IPW$RQS 
IPW$AQS 
IPW$GQS 
IPW$DQS 
IPW$FQS 



Data management 



j Purpose 



— 1 
I 



IPW$PDR 
IPW$GDR 



Account management 



IPW$OAF 
IPW$CAF 
IPW$PAR 
IPW$GAR 



Other functions 

IPW$IAS 
IPW$ICP 
IPW$IOC 
IPW$SRJ 
IPW$SXJ 
IPW$ULP 
IPW$GSL 
IPW$RMS 
IPW$OEF 
IPW$OTP 



reserve queue record 

add queue Set to chain 

get next queue set from chain 

delete queue set from chain 

release queue set 



put data record 
get data record 



open account file 
close account file 
put account record 
get account record 



invoke asynchronous service 

invoke command processor 

invoke outboimd compaction manager (IPW$$OC) 

scan reader JECL statement 

scan execution JECL statement 

update LUB and PUB tables 

get source statement library record 

request message service 

open diskette file 

ope n ta pe 






,4 



32 DOS/VS POWER/VS Logic 



c 



j Service Macros 

^ 

Task management CIM) 

IPW$ATT 
IPW$DET 
IPW$WFI 
IPW$WFO 
IPW$WFL 
IPW$WFiyi 
IPW$WFQ 
IPW$WFC 
IPW$WFS 
IPW$WFD 
IPW$FCH 



Resource management (RM) 



I Purpose 
-+ 



IPW$RSR 
IPW$RLR 



•Storage management (SM) 



IPW$RSW 
IPW$RLW 



Message service (MS) 



IPW$WTO 
IPW$WTR 



Disk service (DS) 



IPW$WTQ 
JPW$RDQ 
IPW$WTD 
IPW$RDD 



Tape service (TS) 



IPW$WTT 
IPW$RDT 
IPW$CTT 



Timer service (TIS) 
IPW$RDC 

Validation service (VS) 
IPW$VDA 



attach new task 

detach current task 

wait for initiation 

wait for operator 

wait for locked resource 

wait for list posting 

wait for class table posting 

wait for single posting 

wait for storage posting 

wait for dispatch 

fetch transient (wait for PTA/LTA) 



reserve resource 
release resource 



reserve work space 
release work space 



write to operator 

write to operator with reply 



write queue record 
read queue record 
write data block 
read data block 



write tape record 
read tape record 
execute tape control 



read (TOD) clock 



validate data area addresses 
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.«. «^ .^^^ .„„. . . „^ ^.„ ^ 



I Definition Macros 

I IPW$DAC 
I IPW$DAB 
] IPW$DBC 
I IPW$DCB 
I IPW$DCO 
I IPW$DCT 
I IPW$DCW 
|IPW$DDE 
I IPW$DDR 
jIPW$DDV 
I IPW$DGN 
I IPW$DLC 
|IPW$DLR 
I IPW$DLU 
|IPW$DiyiC 
j IPW$DMD 
I IPW$DMM 
i IPW$DMS 
I IPW$DPA 
I IPW$DPC 
I IPW$DPD 
! IPW$DPW 
I IPW$DRM 
i IPW$DQC 
I IPW$UQR 
! IPW$DSC 
I IPW$DSL 
I IPW$DSR 
I 1PW$DSU 
I IPW$DSV 
|IPW$DTB 
I IPW$DTC 
I IPW$DTE 
jIPW$DWA 



I Purpose 

I define account control block (ACB) 

I define asynchronous service anchor block (ASWS) 

I define buffer control area (BCA) 

I define command control block 

I define compaction control block (COCB) 

I define class table entry 

I define channel command word 

I define device entry 

[define data record format 

I define device table 

I define generation table (GNB) 

I define line control block (LCB) 

(define logon request control block (LRCB) 

I define logical unit control block (LUCB) 

[define module control block (MCB) 

I define message definition module 

[define message control block (MSCB) 

j define RJE (BSC and SNA) message control block (MMB) 

jdefine permanent area (CAT) 

! define pagfe control block (PCB) 

jdefine partition control block (PDB) 

I def iije physical work space (PWS) 

I define SNA remote control block (RMCB) 

I define disk management block (DMB) 

[define queue record (QRA) 

I define storage control block (SCB) 

[define SLI work space (SLW) 

I define service request block (SRB) 

] define SNA unit control block (SUCB) 

[define save area 

j define tape control block (TBB) 

[define task control block (TCB) 

I define task control block extension area 

[define SNA work area (WACB) 



X ^ 



J 



L L . . , 



— J 



— 1 
I 



(Miscellaneous Macros [Purpose 
(. . ^ 



[Entry exit 

1 

[ IPW$SAV 

I IPW$RET 

|IPW$ALN 

|IPW$EQU 



! 

1 save caller registers 

[restore registers and return to caller 

[align to storage boundary 

j establish equates 

-i ■ . , 
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Initialization and Termination 
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INITIALIZATION OF POWER/VS 

The initiation of POWER/VS comprises three phases: 

• User-generated phase (POWER/username) 

• IPW$$I1 

• IPW$$I2. 

Job control (EXEC statement processor) fetches the first of these three phased, which 
contains a small loader routine and a generation table. These are assembled from the 
generation macros POWER, PLINE (optional) and PRMT (optional). There can be as many of 
these generation table phases in the core image library as there are different versions 
of POWER/VS needed by user. 

The loader routine in front of the generation table loads phase IPW$$I1 behind the 
generation table and gives control to it (see Figure 2.3). 

IPW$$I1 checks the environment in which POWER/VS has to be executed to ensure that the 
following conditions are satisfied: 

Only one POWER/VS program active at one time. 

SYSLOG must be assigned to a console device. 

POWER/VS must be a main task. 

Run mode must be virtual. 

DOS/VS supervisor must have JAI support if POWER/VS supports job accounting. 

DOS/VS supervisor must have POWER/VS support. 

Remote terminal ID'S are validated for RJE,,SNA. 

Size of GETVIS area is checked for RJE,,SNA. 

Line addresses are validated for RJE,, BSC-. 

Size of pageable area is checked. 

Real storage allocation must be at least lOK; if more than 128K,, then 128K is forced. 

If IPW$$I1 finds the environment to be satisfactory,, it loads the next initiator phase,, 
IPW$$I2, into the pageable area and gives control to it (see Figure 2.3).. 

IPW$$I2 is the main initiator phase that actually loads and starts up POWER/VS: 

• Saves the generation table in itself,. 

• Loads the POWER/VS nucleus (8K permanent area: PFIX 4 pages). 

• Initializes control blocks in nucleus and relocates various addresses. Generation 
table information is moved to various control blocks. 

• Loads all required pageable phases behind itself in the pageable area (for required 
IPW$$xx phases,, refer to "Programming Requirements" in Section 1) using a Local 
Directory List. 

• Calls $$BPOWIN to change PSW key to zero. 
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Initiates a TCB chain^ to enable itself to run on as a task and make use of functions 
and services provided by the nucleus. This TCB chain is also used as a base for the 
task selection mechanism to attach more TCBs (tasks). 

The spool manager master TCB will be at the end of the chain when the FOWER/VS 
cross-partition communication interface option is specified in the POWER generation 
macro. 



TMTN 



Wait control block 




Permanent Command Processor TCB 



Initiator TCB 

Figure 2.2. Initial Task Selection (TCB chain) 

• If SYSIPT is assigned to a unit record device/ Autostart control cards are read from 
it. In this case IPW$$I2 acts as a physical reader and links to IPW$$LR to write the 
data to the spooling device. Then it uses IPW$$LW to retrieve this data for 
processing of the statements. 

• Opens POWER/VS direct access files using DTFPH. 

• Processes FORMAT= statement (optional formatting of the POWER/VS direct access files). 

• At the end of initialization,^ a status report is printed (if SYSLST is assigned), an 
"initialization complete" message is issued, and SYSRDR, SYSPCH, SYSLST, SYSIPT are 
unassigned in the POWER/VS partition. The initiation TCB is posted to be inactive and 
control is given to POWER/VS task selection. 
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GENTAB loads IPW$$I1 

IPW$$I1 loads IPW$$I2 (start of pageable area) 
IPW$$I2 loads IPW$$NU (start of virtual partition) 
IPW$$I2 loads other POWER/VS code (see Figure 1.7), 



Figure 2.3. Initiation Logic 
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TERMINATION OF POWER/ VS 



POWER/VS is normally terminated by the PEND command. All active tasks are allowed to 
continue until they finish processing the current queue entry. Deactivation is handled 
by each of the tasks,^ ^fter the command processor (IPW$$CP) has set a termination code 
("S", "E", or "F") in their TCBs. In case of an I/O error, POWER/VS can also be 
terminated by the IPW$$TR phase (see "Abnormal Termination of POWER/VS"). 

After all supported partitions have been released^ the POWER/VS partition is restored for 
normal DOS/VS operation. 

The detach routine of task management actually gives control to the terminator routine 
within IPW$$I2„ which executes as a subtask. 

The terminator routine performs the following functions : 

• It closes POWER/VS files (writes master record back to queue file, and writes 
end-of-file record to account file). 

• Optionally prints status report, especially for the queue file,, by passing an internal 
PDISPLAY card to invoke P status task (if SYSLST assigned to a printer). 

• Issues termination message. 

• Issues EOJ macro which also PFREEs the permanent area and all other fixed pages. 

The DOS/VS EOJ processor $$BE0J4 then gives control to $$BPOWIN„ which performs the last 
terminating action: 

• Restores POWER/VS partition for normal use. 

Abnormal Termination of POWER/VS 

The termination routine IPW$$TR is entered from task selection C state processing in case 
of an error at completion of any I/O operation. It executes under the TCB of the failing 
task. The failing task is canceled. 

The following specific failures necessitates POWER/VS termination: 

• failure of the permanent command processor task 
I • logic error of POWER/VS function encountered 

• failure during initiation of POWER/VS 

• I/O error while IPW$$TR is trying to recover 

• I/O error on the master record 

• I/O error while obtaining a record from the free queue set in the queue file 
(IJQFILE). 

POWER/VS can also abnormally be terminated by the PEND KILL command. As a result of this 
command a dump will be printed by the Command Processor (optional), after which an EOJ 
macro is issued. 
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POWER/VS MULTITASKING 



In order to execute POWER/VS tasks concurrently^ but asynchronously,^ POWER/VS 
incorporates multitasking support. Because this support does not depend on the 
multitasking (asynchronous processing) support provided in DOS/VS, it is called 'private 
multitasking' . 

Each POWER/VS task is equipped with a task control block (TCB) created in fixed storage,. 
The TCB is used to establish the identity of the task and to preserve its status when it 
is not in active control of the central processor. 

The task control blocks present at any time in POWER/VS are linked together by means of 
•next task' and 'previous task' pointers to form a logical list called the 'task 
selection list'. The task selection list is considered to begin and end with the Wait 
Control Block (WCB) ,, a skeleton TCB whose function is to delimit the task selection list. 

The logical position of each task control block within the task selection list (see 
Figure 2.4) deteinnines its dispatching priority relative to the other tasks within the 
list. This priority takes effect only when task selection is entered; once a task is 
running it will continue to run until it yields control by means of one of the task 
selection service macro instructions (IPW$WFx) or sustains a page fault. Thus, a higher 
priority task will not interrupt a running task. 

An initial task selection list is constructed by the POWER/VS initiator (IPW$$I2). This 
list contains the wait control block, the task control block of the initiator task,, and 
the task control block of the permanent command processor task. All further additions to 
and deletions from the task selection list are performed by the task management service. 

POWER/VS provides three components of task management service: 

• Task initiation - attach new task 

• Task selection - select next task for dispatch 

• Task termination - detach current task 

Each of these components will now be discussed in greater detail. 
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Figure 2,4. Task Selection List (TSL) 



TASK INITIATION 



Task initiation is entered from a POWER/VS task by means of the IPW$ATT (attach new task) 
macro instruction. The issuing task has already acquired storage for and formatted the 
task control block which will represent the new task; in particular it has created the 
task storage descriptor which establishes the task type and identity- 

Task initiation determines the point within the current task selection list at which 
the new task control block must be inserted,, and adjusts the 'previous task* and 'next 
task* pointers within the task control blocks concerned. The new task is then set into 
D(dispatchable) state^ and return is irade to the calling task. 
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Figure 2.5. Attaching a Task 



TASK SELECTION 



Task selection is entered from a POWER/VS task v?hen that task yields control to the 
central processor by means of one of the IPW$WFx (wait for 'x') macro instructions listed 
below. In each case 'x' represents the task state value to be associated with the task 
yielding control. 

IPW$WFI -- set I state and wait for initiation, 

IPW$WFO - set O state and wait for operator response. 

IPW$WFL - set L state and wait for locked resource,. 

IPW$WFM - set M state and wait for multiple control block posting,. 

IPW$WFQ - set Q state and wait for class table posting or multiple XECB posting- 

IPW$WFC ~ set C state and wait for SCB or CCB posting. 

IPW$WFS - set S state and wait for ECB or CCB posting, 

IPW$WFD - set D state and wait for re-^dispatch* 

(The significance of these individual states will emerge in the discussion of the 
routines that issue the individual macro instructions.) 



The status of the task yielding control is saved by storing the current contents of the 
general purpose registers (and the condition code) in the task register save area of the 
task control block. This done, the task selection process can begin. 

The task Selection list is used to address and examine each task control block in turn in 
order of dispatching priority to determine whether the associated task can be dispatched. 
This is done by means of the task state value set in the task control block. (In 
addition to the task states listed above,, two further states must be mentioned: P state 
(page-bound), which is set by the page fault appendage (see "POWER/VS Appendages") when a 
task sustains a page fault, and F state (fetch-bound) , which is set when a task requires 
to fetch a transient routine but finds that the necessary transient area is in use.) 

Tasks in the following states are non-dispatchable : 

I state - the task is waiting for reactivation* 

P state - the task is waiting for a page-in operation. 

O state - the task is waiting for operator response. 
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Tasks in the following states are conditionally dispatchable. A further test or tests 
must be performed to determine whether the condition has been satisfied and the task i6 
in fact ready for dispatch. 

L state - the task i^ waiting for a locked resource. 

F state - the task is waiting for access to a transient area. 

S state * the task is waiting for ECB or CCB posting. 

C state - the task is waiting for ECB or CCB posting. 

Q state - the task is waiting for class table posting or multiple XECB posting. 

M state - the task is waiting for any of a set of ECB or CCB postings. 



Tasks in the following state are unconditionally dispatchable: 

D state - the task is ready for immediate dispatch. 

As soon as a dispatchable task is found within the task selection list, the general 
purpose registers (and condition code) are restored from the task register save area of 
the task control block,, the ta6k is set into R state (running),, and execution of the task 
is resumed from the point at which it previously ceased. 

If the entire task selection list is Scanned without any task being found to be 
dispatchable, the task selection Service issues an SVC 7 to pass control to the DOS/VS 
supervisor. POWER/VS will wait till the occurrence of some related event (I/O 
completion, for example) causes DOS/VS to return control to the task selection service. 
The entire task selection process is then repeated. 
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Figure 2.6. Overview of Task Selection 
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TASK TERMINATION 



Task te:pmination is entered from a POWER/VS task by means of the IPW$DE'r (detach current 
task) macro instruction. 



Task termination removes the task control block of the current task from the task 
selection list by adjusting the 'previous task' and 'next task' pointers within the 
neighbouring task control blocks within the list. The storage occupied by the eliminated 
task control block is returned to the system, and control is then passed to task 
selection to determine the task next to be dispatched. 
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Figure 2.7. Detaching a Task 
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Figure 2,8. Data flow throughout the spooling process 
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REAt)ER TASKS 



The reader task is executed by a physical reader routine (PR) and logical reader routine 
(LR) . These routines pass control to each other through a logical record interface. At 
unit exception^ the task, places itself in a dormant state^ releasing as much v?ork space 
as possible. 

Hot reader support enables a dormant task to continue v\?ithout a PSTART command^ if new 
input has become available (refer to "Device End Appendage"). 

Physical Reader (PR) 

The PR is entered when a reader task is invoked by a PSTART command., or when an 
unsolicited device-end interrupt occurs while the task is in a dormant state (hot reader 
support). Special work areas will be allocated at entry time and initialized according 
to the supported physical device. The work areas can be released by the termination 
routine IPW$$TR. 

The PR performs the physical input for one or more devices and establishes the linkage 
with the LR so that, on request,, each logical record can be passed over the interface to 
the LR. 

Each input operation will handle a number of records by means of command chained CCWs 
(refer to "Physical Data Redord area" in Section 5). The input operation is performed 
with real addresses in the CCWs (EXCP real). 
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Physical 35ti0 Diskette Reader (ER) 

This routine is entered via the logical reader when a RDR statement is encoijntered in the 
input stream, or via task selection as a result of a ^START command issued for the 
diskette reader only. It reads data from the physical diskette reader associated with 
the reader task. 

Logical Reader (LR) 

The first time the routine is entered, it reserves work space for the queue record area 
and acquires a queue record from the free queue set (via IPW$RQS macro instruction). 

The values may be overwritten by specifications in the JECL statements (* $$ JOB and 
* $$ CTL) . Records passed via the logical record interface will be passed in turn to the 
put data function routine (PD) for writing to the data file. The general purpose byte in 
the record request word (RRW) indicates what action is to be taken by the PD routine- 
General purpose byte posted by LR: 

Data break for // EXEC, /* records (used for performance reasons) 
End of data for last record for this job entry 
End of block in case of unexpected end of input 

(expected delimiter not encountered, or last record of block). 

The routine provides a user exit. It enables a user-written routine to . examine each JCL 
and JECL statement and delete or insert records in the job stream* 

If the last record for the currently processed job entry is passed., the IPW$AQS macro 
instruction is issued (to invoke the add queue function) to add a queue record on the 
queue file. 



EXECUTION PROCESSOR TASKS 

Each serviced DOS/VS partition is equipped with a partition control block (see Figure 
5.21). A partition control block is created within the POWER/VS fixable area whenever a 
partition is brought under the control of POWER/VS by means of a PSTART command. 

The partition control block contains header information pertinent to the partition itself 
and a set of one or more device entries- Each device entry relates to a single real or 
dummy physical device specified by the operator at the time at which the partition 
control block is created and thereafter defines that device to POWER/VS. 

The first device entry within each partition control block describes the reader device 
for that partition. If the partition is a writer-only partition the device described by 
the reader entry is the system console device. Further device entries describe the list 
devices and punch devices for the partition- 
Each device entry is used to pass information from the user partition to the POWER/VS 
execution processor task which is responsible for the emulation of that device. 

The execution processor tasks are: 

• Execution read task (XR and XJ) 

• Execution writer tasks (XW). 

An execution read task is started for each partition at the time at which the partition 
is brought under POWER/VS control. It continues to run until the partition is returned 
to DOS/VS control by means of a PSTOP command. 

The execution read task is responsible for servicing all read requests addressed by the 
user program to the partition read device designated at partition PSTART time. It is 
additionally responsible for recognizing the first request addressed by each job executed 
within the partition to each of the partition list and punch devices designated at 
partition PSTART time,, and initiating an execution writer task to service the further 
program requests addressed to that device. 
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Until end of job the execution tasks proceed concurrently but asynchronously. When the / > 
execution reader detects an end-of-job condition it posts a stop condition to each of the 
subordinate tasks that it started. It then waits until each of these tasks detaches ^ -^ 

itself in turn. 

If no other queue entry can be processed the reader task will place itself in a wait 
state, after a message is issued. When a PSTOP command is issued the reader task and its 
subordinate tasks will eventually be detached after processing the current queue entry. 

Execution Reader Routines (IPW$$XR and IPW$$XJ) 

This routine will emulate the user channel program input requests for the reader device. 
To service these requests a data record is kept available throughout the process of this 
routine. Records are retrieved via IPW$GQS and IPW$GDR macro instructions. The routine 
does the following: 

• Intercepts first request for output of the user channel program,, and then attaches a 
subordinate writer task. 

• Handles all input requests from the user channel program. 

• In case of a writer- only partition,, analyzes JECL statements from a console read 
operation and starts a writer task. 

• Indicates termination of a writer task once a queue entry has been processed or a data 
break condition is recognized. 

• When an SLI JECL statement is encountered,, initiates for the insertion of source 
statement library records. 

• When PUN,, LST, or PRT JECL statements are recognized,, terminates the appropriate x \ 
writer task, builds a new queue record,, and starts the writer task again. ; 

\ .y 

Execution Writer Routine (IPW$$XW) 

At entry of the execution writer routine,, the execution read task reserved queue space 
and initialized (from * $$ LST or * $$ PUN) the queue record area. 

Space is reserved for the data buffer for the output records. If a request from the user 
program is foiand in the task list entry of the partition control block,, the user channel 
program is emulated. If no entry is found the task enters a wait state for further user 
program requests. 

Each CCW is checked for validity and user data is transferred to the data file by 
invoking the put data record function. 

At termination of the task, which is controlled by the execution reader task (stop code),, 
a dummy end of data record is passed to the piit data routine, and the current queue set 
is added to the appropriate class chain by invoking the add queue record fimction. The 
data buffer is released and the task detaches itself* 

Output segmentation is driven by count (as specified in JECL) or by the user 
program (via an FCB buffer load or by issuing a SETPRT or SEGMENT macro) and is 
established through formation of a new queue set. The former queue set is 
added to the appropriate class chain. 
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Any request to alter the printer setup, either via a // SETPRT statement or a SETPRT 
macro instruction, is routed to SETPRT. When SETPRT determines that the device is being 
trapped by POWER/VS , it passes the SETPRT parameter list to POWER/VS after a basic 
validation. This is done by issuing an I/O to the device with an 'FD' channel command 
operation code, and with the data area address pointing to the SETPRT parameter list. 
The execution processor recognizes the 'FD' operation code as a valid command for the 
3800. 

The execution processor maintains a control block, called the TCB extension area, which 
contains the current printer setup of the device being spooled. When a SETPRT parameter 
list is encountered by the execution processor, the TCB extension area is updated, which 
means the new setup request is merged with the previous one. 

When the BURST, FORMS, FLASH, or copy group specifications have been changed, the output 
is segmented (that is, the output entry is closed and added to the class chain according 
to the priority; then a new output entry is created with the same jobname and job 
attributes but with a different job number, in order to facilitate queue manipulation by 
the operator) . The SETPRT parameter list is then written as the first record in the new 
list queue entry. 

Whenever the execution processor detects that a valid CINDX value (other than or 1) was 
specified in the SETPRT parameter list, it assumes that the user will manage the copy 
group handling by himself. 

The execution processor creates a new output LIST entry with the same job attributes and 
sets the transmission count to one. 

When a SETPRT parameter list contains an FCB specification, the FCB image is loaded from 
the core image library and the internal representation of the page format is updated. 
The FCB phase name is saved in the TCB. The FCB image is validated for accuracy. If a 
3800 FCB image is invalid, a message (IQ54I) is written to the operator and the hardware 
default FCB is used. The LTAB specification is assumed as the internal representation of 
the FCB. 
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The following 3800 CCW operation codes are not accepted by POWER/VS (execution 

writer) and cause the channel program check and the unrecoverable I/O error 

flags in the CCB to be posted: v ^ 

Load translate table (X'83') 

Load character module WCGM (X'53') 

Load forms overlay sequence control (X'43') 

Load copy number (X'23') 

Load graphic character modification (X'25') 

Load copy modification (X'35') 

If the user is prepared to accept unrecoverable errors, control is returned to 
him in the normal way; otherwise, a cancel flag is set in the PIE of the user 
partition to force cancellation of this job. 

The following 3800 CCW operation code is ignored: 

• clear printer (X'87') 
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WRITER TASKS (LIST AND PUNCH) 



The writer task is executed by a physical routine (PL or PP) and a logical routine (LW) . 
These routines pass control to each other through a logical record interface. If no next 
job is available, the task places itself in a dormant state, releasing as much work space 
as possible. 

Physical List and Punch 

These routines are entered when a list or punch task is invoked by a PSTART command. At 
entry, special work areas are allocated and initialized according to the supported 
physical device (see Figure 2.9). The work areas can be released, by the termination 
routine IPW$$TR.. Both routines perform physical output. On request, the linkage allows 
logical records to be received in turn over the interface from the logical writer 
routine. 

When a 3800 Printer list task has been started, a request is made to asynchronous service 
to attach a DOS/VS subtask. The subtask then is responsible for doing all SETPRT 
requests. ^he list writer task may be stopped during initialization when: 

• No DOS/VS subtask available 

• No GETVIS storage for SETPRT workspace 
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Each output operation will print or punch a number of records by means of command- 
chained CCWs (see Figure 5.15). The output operation is performed with real addresses in 
the CCWs (EXCP real). 
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Logical Writer 



A new queue set is addressed by invoking the get next queue set (NQ) function. A logical- 
record is retrieved from the data file by invoking the get data record (GD) function. 



H^ y 



The logical record is passed over the interface to the physical routine. The general 
purpose byte is tested for following action to be taken: 

• Normal record: retrieve the following logical record. 

• End of data record: delete the queue set by invoking the delete queue set function 
and address the next queue set to be processed. 
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Functions 



This chapter describes only the queue and data management functions because they require 
an explanation of the organization of their respective files. 

QUEUE FILE ORGANIZATION 

Three types of records are physically present on the queue file: 

a master record queue identifier M (physical first in file) 

queue records queue identifier F, R^ L, or P 

a dummy record queue identifier D (physical last in file). 

Logically, by means of pointers, the queue records are either a member of the free queue 
set or a member of a queue set that is in turn a member of a class chain. 

Records in the free queue set (queue identifier F) are chained by the next-in-set 
pointer. A next-in-set pointer with value zero delimits the chain. The start of this 
chain is kept in the master record. 



queue record •^- — 



(■) 0) © 

master record [ ^| queue record ^l M 

© 
© 



queue record 



MRQF field in master record 

QRNS field in queue record {zero=last) 



Figure 2.10. Free Queue Set 

Each record in the free queue set has a pointer to a unique track group on the data file 
available for use. 

For each queue entry of a class chain, there is a first-in-set queue record, which 
provides forward and backward pointers in the class chain. If more than one track group 
of the data file is required for a queue entry, additional queue records are chained to 
the first-in-set queue record by the next- in-set pointer. Each of these additional 
records points back to its first-in-set queue record. 
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Figure 2.11 • Class Chain and Queue Set 

The master record and the queue record currently processed by a task are contained in 
storage. The roaster record in the Disk Management Block (DMB) and the queue record in 
the fixable area. 



DATA FILE ORGANIZATION 



The space available on the data file is arranged in track groups, each containing an 
integral number of tracks. Each track group has a fixed relationship with a queue record 
in the queue file. Hence, a queue record in the free queue set will point to an 
available track group. A queue record in a class chain will point to a track group that 
is in use. 

Each physical record (fixed length) in the data file contains one or more logical 
records. Each logical record represents a unique record of the user program that is 
being spooled. The following figure shows the layout of a physical record: 
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RL - length of the logical record 

GP - general purpose byte (see also section "Logical Reader") 
CC - command code associated with the user channel program 
* trailing blanks are suppressed 

Figure 2.12 • Data Record 
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QUEUE FILE AND DATA FILE PROCESSING 



The queue and data file are maintained by the queue and data function routines: 

• Reserve queue record (IPW$$RQ) 

• Add queue set (IPW$$AQ) 

• Delete queue set (IPW$$DQ) 

• Free queue set (IPW$$FQ) 

• Put data record (IPW$$PD) 

Retrieval on the queue and data files is perforined by the function routines: 

• Get next queue set (IPW$$NQ) 

• Get data record, ( IPW$$GD) 

The reserve queue record function obtains the first record from the free queue set and 
updates the pointer in the master record to the next record in this set. If the queue 
file is exhausted, that is,, no free queue record is available, the task is placed in a 
wait state until queue records in use are returned to the free queue set. 

The add queue set function inserts,, by means of its next and previous pointers a new 
queue entry in the appropriate class chain. 

The delete queue set function removes a queue entry, which is no longer required,, from 
its class chain. The free queue set function returns the queue records to the free queue 
set. 

The put data record function moves a logical record into the output area for a physical 
record on the data file. If the output remainder is not large enough to contain this 
logical record, the output area is written to the data file as a physical record. If the 
track group is exhausted,, a new queue record is obtained from the free queue set 
(explicitly coded without invoking a function). 

The get next queue set function obtains the first queue record of a new queue set from a 
class chain referenced by the calling task. Class chains relating to the calling task 
are identified by a task class list in the TCB (see Figure 5.10). Each entry in the task 
class list is examined, in turn. If the cla^s chain it addresses is not empty, the queue 
sets which it contains are examined in turn until a set is found to be dispatchable. A 
positioning error occurs for the failure of a GETSPOOL request,. 

If all addressed, class chains are empty or contain non-dispatchable queue sets,, the 
calling task is placed in a .wait state until a new queue set is added or an existing 
queue set becomes dispatchable. For a GETSPOOL request,, the queue records are scanned 
for a matching job name and class with the one supplied in the GETSPOOL SPL. 

The get data record function provides the calling routine with a logical record by means 
of the record request word. If the input area is exhausted a new physical record will be 
read from the data file. If the track group is exhausted the next queue record in the 
set will be obtained to address the next track group on the data file for the queue entry 
that is in process. 
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ASYNCHRONOUS SERVICE 



The asynchronous service function of POWER/VS handles all SETPRT requests for the 
following reasons: 

• SETPRT processing may use an extended time. 

• Page faults in the SETPRT module would be otherwise handled by POWER/VS. 

• Since the SETPRT module does not follow the POWER/VS register convention, page faults 
cannot be handled by POWER/VS. 

Asynchronous service consists of 4 parts: 

• ATTACH asynchronous service subtask 

• DETACH asynchronous service subtask 

• INVOKE asynchronous service subtask 

• Asynchronous service subtask 

INVOCATION OF ASYNCHRONOUS SERVICE 

Before a POWER/VS task can use asynchronous service, an ATTACH request must be issued. 
This causes a DOS/VS subtask to be attached if one has not already been attached. Once 
an ATTACH request has been issued by the task, all SERVICE requests can be issued by the 
task. Finally, if asynchronous service is not needed any more, usually at task 
termination, a DETACH request must be issued in order to release the DOS/VS subtask. 

Linkage to the asynchronous service function is established by the IPW$IAS macro 
instruction. 

The macro invocation is as follows: 
IPW$IAS TYPE=xxxx 

Three different specifications of the type keyword are possible: 

ATTACH - Attaches, if not already done, a DOS/VS subtask. 

DETACH - Detaches, if necessary, the DOS/VS service subtask. 

SERVICE - Invokes the asynchronous service subtask and passes the service request block 
to it. 

Register' 1 is assumed to point to the service request block (SRB) . 
It is the invoker's responsibility to build the SRB in the proper way. 
Service is the default and may be omitted. 

Following registers are used: 

RO - function type 

R1 4 - return address of caller 

R15 - entry point address of IPW$$AS 

Note : When TYPE=SERVICE is specified, register 1 must point to the service request 
block. 
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The DOS/VS subtask is attached only once. A use count is used to keep track of how many 
POWER/VS tasks use the asynchronous service subtask. Whenever a POWER/VS task requests / 
attachment of the DOS/VS asynchronous service subtask, the use count is incremented by \,^ 
one. When the use count is set to one, the actual attach of the subtask is performed. 
When no subtask is available, a message is issued to the operator, and the task 
requesting the attach is terminated. On the other hand, when a detach is requested by a 
POWER/VS task, the use count is decremented by one. If the use count becomes zero, the 
DOS/VS subtask is detached. However, the asynchronous service anchor block still exists. 

When a service request is issued by a POWER/VS task, the service block (pointed to by 
register 1) is chained as the last entry in the service request queue, and the 
asynchronous service subtask is posted. The asynchronous service anchor block (ASAB) is 
unlocked and the task waits for the completion of the service request. After the 
completion of the service request, its ECB is posted by the subtask. The ASAB is locked 
and the service request block is unchained from the queue. If POWER/VS detects a chain 
error, an appropriate error message is written to the operator, and POWER/VS is 
abnormally terminated. Otherwise, the return code set by the subtask is analyzed and the 
appropriate action is taken. 

When the attach function is entered the first time, storage for the asynchronous service 
anchor block (ASAB) is reserved. The ASAB exists as long as POWER/VS is active. The 
asynchronous service anchor block contains: 

• Pointers to first and last entry in the service request queue. If there is no entry 
in the queue, the pointer to the first service request block is zero, but the pointer 
to the last service request block contains the address of the last service request 
being performed. 

• DOS/VS subtask communication ECB 

• Address of SETPRT routine in SVA 

• Lock word V. 

The asynchronous service function is serially reusable and is locked for the duration of 
the appropriate subf unction (ATTACH, DETACH, or SERVICE) . 
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RESOURCE MANAGEMENT 

Resource management is responsible for the protection of serially-reusable resources 
(control blocks) against concurrent access by more than one task. Entry to the services 
is made by means of the macro instructions IPW$RSR (reserve resource) and IPW$RLR 
(release resource). 

Reserve Resource 

This service is entered when a POWER/VS task issues a IPW$RSR macro instruction. 

The resource lockword (bytes 28-31 of each resource control block) is examined. If the 
resource is not available (lock byte contains X'FF') the routine waits till it is 
available (by issuing IPW$WFL macro to task management) . If the resource is available,, 
ownership of the resource is established by storing the address of the TCB of the owning 
task in bytes 1 to 3 of the lockword. 

Release Resource 

This service is entered when a POWER/VS task issues a IPW$RLR macro instruction. 

The resource lockword owner address is examined. If the task issuing the release request 

is not the resource owner the request is ignored. Otherwise^ the lock byte in the 

resource lockword is set to zero so that the resource becomes available for use by any 
other task that may require it. 

displacement 28 



^ ; ^ 


Lockword 




FF 


address 
OfTCB 


(any resourte control block) 


1 3 



Figure 2.13,. Resource lockword of a POWER/VS control block 



STORAGE MANAGEMENT 

Storage management controls the real storage allocated to the POWER/VS partition. Work 
space in the fixable area for a task is reserved and released as requested by the calling 
routine. 

The storage control block (SCB), with storage assignment table (isomorphic map of all 
pages in fixed area),, page control blocks and associated buffer control words (BCWs) are 
used to control the availability of real address storage in the POWER/VS partition (see 
Figure 2.14. The SCB is locked during handling resource/release request. 

Reserve Work Space 

This service is entered when a POWER/VS task issues a reserve work space (IPW$RSW) macro 
instruction. The buffers in the currently fixed pages are scanned to determine whether 
the required work space is available. If the space required is not available in the 
existing buffers, a new page is fixed (PFIX), in the POWER/VS real partition. Space is 
then allocated in the new page. The virtual and real addresses are passed to the calling 
routine. 
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Release Work Space 

This service is entered when a POWER/VS task issues a release work space (IPW$RLW) macro 
instruction. The buffer is cleared (binary zero) and the appropriate buffer control 
words are updated. If the page is no longer in use (all buffers are cleared) the page is 
freed (PFREE). 
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Figure 2.1U. Storage manageuient control blocks relationship 

MESSAGE SERVICE 



last fixed page 
} see detail Ta j 



I This service is invoked by a IPW$WTO or IPW$WTR macro instruction issued by the calling 
routine. It performs a console write operation or a write operation followed by a read 
operation,, defined by information supplied by the calling routine in the message request 
word located in the TCB. (See Figure 2.16.) The message request word and reply request 
word contain the addresses of message and reply areas of the calling routine. 

There is a message control block (MMB) „ which is locked for the duration of the 
operation. It contains the channel program, the CCB, the message output area and the 
reply input area. 

The variable portions (lower case characters) of the message text are converted to 
indicate information pertinent to a specific task or queue entry. 



X, 
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Figure 2.15, Message service control block relationship 
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DISK SERVICE 



I This service is invoked by IPW$RDQ>, IPW$WTQ,y IPW$RDD,, or IPW$WTD macro instructions 
issued by the calling routine. It reads or writes records to the queue file or the data 
file defined by the information supplied by the calling routine in the I/O request words 
in the TCB,. 

The I/O reque.st word contains the record seek address and the real and virtual addresses 
of the data or queue record area. 

The first byte (M) in the record seek address is used to locate the associated Module 
Control Block (MCB) via the MCB address table in the CAT (control address table of 
IPW$$NU). 

There is one MCB for every queue or data module,^ which is locked for the duration of the 
operation. It contains the CCB and skeleton channel program^ which is appropriately 
initialized for each I/O operation. 
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Figure 2,16. Disk management control blocks relationship 



TAPE SERVICE 

This service is invoked by IPW$WTT, IPW$RDT, or IPW$CTT iracro instructions issued by the 
calling routine. It reads or writes records to tape file, or performs a tape control 
operation defined by information supplied by the calling routine in the I/O request words 
in the TCB. 

Associated with the tape device is a Tape Control Block (TBB) , counting the CCB and 
skeleton channel program which is appropriately initialized for each I/O operation. 
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Figure 2.17. Tape service control blocks relationship 
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TIMER SERVICE 



This service is invoked by the IPW$RDC macro instruction. It issues a GETIME standard 
macro instruction to obtain the time of day in packed decimal format. Also, the date 
field in the master record is updated with the value stored in the partition 
communication region. 

VALIDATION SERVICE 



This service is invoked by the IPW$VDA macro instruction. The data address and its 
associated length which are provided in the user- supplied channel command word and the 
address of the CCW itself are examined to ensure that they relate to a data area that the 
user is allowed to access. 

The following table shows which areas the user is allowed to access: 

Write/ 
Read Control 

Operation Operation 



User's partition 


Yes 


Yes 


LTA (logical transient area) 


Yes 


Yes 


SVA (shared virtual area) 


No 


Yes 



( 



Jf^N, 
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Command Processor 



The command processor (IPW$$CP) will be under control either of a permanent TCB located 
in the nucleus code or a temporary TCB in the fixable area. 

The permanent command processor task is invoked by the attention interface appendage when 
an operator command is received from the console. 

The temporary command processor task is invoked by the IPW$ICP macro interface 
instruction. 

On entry of the command processor the command to be analyzed and acted upcn is contained 
in a command processor control block (CPB). 

Initiation of the permanent command processor task 

The attention routine $$BATTNA will pass control to the attention interface appendage in 
IPW$$NU for a potential £>0WER/VS command. In the appendage routine the command is 
verified and stored with its operands in fixed positions in the command processor control 
block (CPB). The command processor task is set dispatchable and normal return to 
$$BATTNA is taken. 

In the case of an invalid command or if the command processor is not inactive an error 
return to $$BATTNA is taken, resulting in an invalid statement message,. 

Initiation of a temporary command processor task 

The POWER/VS routine that wants to invoke the command processor for processing of a 

POWER/VS command issues a IPW$ICP macro instruction. Processing control is then given to V 

phase IPW$$IC. 

This phase builds and attaches a temporary command processor TCB, with the command and 
its operands in fixed positions in its CPB. 

On exit, the temporary command processor task detaches itself and the permanent command 
processor task will place itself in inactive state. The permanent command processor has 
the highest priority of all common tasks in the task selection list. It enables the 
operator to maintain control over the POWER/VS partition in extreme circumstances. 



COMMAND PROCESSING ROUTINES 



In IPW$$CP, the command code contained in CPB is used to enter the appropriate command 
processing routine. 

Note that the following commands if entered from a SNA terminal are processed by the 
IPW$$IB inbound processor: 

FLUSH 

GO 

RESTART 

SETUP 

SIGNOFF 

START 

STOP 

The remaining commands are given to IPW$$CP for processing. After processing the 
command, control is returned to task management service. The following command 
processing routines exist: 
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PSTART - creates a TCB according to the operand specifications in the comitiand. It 

attaches an execution reader task or a physical reader or writer task or RJE 
task. In case of a partition start it prompts the operator or the initiator 
task (if AUTOSTART) to supply the addresses of the devices to be spooled and 
builds the partition control block. 

PSTOP - posts the termination type in the TCB for the task specified in the first 
operand of the command: 



( 



PGO 



'S' stop immediately 

•E' stop after processing of current queue entry 

'R' stop immediately, resume operation on the next record if the task is 
started again. 

posts the ECB in the TCB for the task specified in the command provided that 
the task was waiting for operator response (task status O) • 



PEND - 



P CANCEL - 
PFLUSIi - 

PRE START 



changes the initiator TCB to terminator TCB,. 

The termination type E will be posted in all existing TCBs . In case of PEND 
KILL, an SVC H\ is issued without posting any termination type and POWER/VS is 
terminated immediately. If a printer address is specified, SYSLST is assigned 

to it. 

cancels status task. 

sets termination type in the TCB for the task specified by the command: 

VF ' current queue entry to be deleted 

'H' current queue entry to be bypassed, but not to be deleted. 

stores the number of records to be skipped, and in the case of a 
3800 Printer also stores the new copy group index to be used, in the 
TCB of a local or remote writer task, according to the operand 
specifications. It also posts an index (type of skip) to this TCB: 

X*04' - restart processing of the queue entry with specified record number. 
X*08' - skip as many records forward as specified. 
X * OC * - skip as many records back as specified. 

changes the disposition of the queue sets specified in the command: 

1. Disposition H (hold) to D (dispatch) 

2. Disposition L (leave) to K (keep). 

displays the message on SYSLOG (via IPW$WTO) or transfers it to the RJE 
message queue, (via IPW$RKiS) , depending on the operand specifications. 

removes the queue sets specified in the command from their class chains (via 
IPW$DQS) ; then priority^ disposition, class, number of copies and remote-id 
can be changed. Finally,, the queue sets are returned to the appropriate class 
chains (via IPW$AQS macro instruction) . 

PDISPLAY - prints a status report. Depending on the option (s) specified in the PDISPLAY 
command, one of the following "subprocessors" will be call'ed: 

DSPLYQ - displays queue status. 

DSPLYA - displays active reader/writer tasks along with job name and job 
number . 

DSPLYM - displays task waiting for operator (task status O) and repeats 
message issued before task was placed in the wait state. 

DSPLYJOB - attaches the print status task (IPW$$PS) to read the queue file and 
extracts the status information required for a report to be printed 
on SYSLOG or on the specified printer. 



PRELhASi 



PBRDCST - 



PALTx„R - 
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DSPLYMSG - displays ALLUSER-type messages from remote message queue, 
DSPYLT - display time, date, pages fixed and number of tasks. 

PINQUIRE - displays status information for RJE lines to central operator: 

• not supported (no line table entiry exits) 

• not initiated (no line control block or SNA control block exists) 

• inactive (no sign-on) 

• processing RJE~id (sign-on) 

PACCOUNT - • builds a TCB for a save account task which will save or delete the account 
file (IPW$$SA) 

• conditionally assigns a free program LUB entry 

• reserves work space for the TCB and attaches it. 

PDELETE - deletes: 

1. queue sets according to the operand specifications in the command. (Via 
IPW$DQS and IPW$FQS macro instructions), or 

2. messages according to the operand specifications from the RJE message 
queue. 

PSETUP - stores the number of pages to be printed in the TCB for a list task according 
to operand specifications. The task is posted dispatchable. The command is 
ignored when no list task exists or when the list task is not waiting for 
operator action. 
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POWER/VS Job Accounting 



ACCOUNT FILE PROCESSING 



Operations on the account file are performed by two functional routines: the put account 
record function (IPW$$lPA) invoked by a IPW$PAR macro instruction, and the get account, 
function (IPW$$GA) invoked by a IPW$OAF,<, IPW$GAR„ or IPW$CAF macro instruction. 

The put account function routine will accept account records for the POWER/VS partition 
and the partitions running under control of POWER/VS (see Figure 2,18). The account 
records (VARUNB format) will be written to the POWER/VS account file under control' of the 
account control block (ACB) . The remaining file capacity is checked against a 20% limit, 
A warning message is issued if the limit is exceeded. 

If the remaining capacity of the account file does not allow to store a presented record,, 
the task concerned is placed in a wait state (wait for ECB posting in account control 
block),, until the account file is emptied by the save account task. 

The get account function routine is broken down into three operations: 

• Open account file for get mode processing,, invoked by IPW$OAF macro instruction. 

• Get account record to retrieve the next sequential record from the account file,, 
invoked by IPW$GAR macro instruction,. 

• Close account file to restore the mode for put account record processing,, invoked by 
the IPW$CAF macro instruction. 

OPEN Account File 

The account control block is initialized for read operations (get mode) to start on the 
first record in the account file. 

CLOSE Account File 

The account file records are erased tiy writing EOF records on each track. The account 
control block is initialized for write operations (put mode) to start on the first record 
in the account file. The task(s) waiting for posting of the ECB in the account control 
block are now allowed to continue processing. 

Save Account Task 

The save account task is attached by the command processor after a PACCOUNT command is 
given. The save account routine (IPW$$SA) is entered when the task gets control. Its 
purpose is to empty the account file, erase it,, or save it on another storage medium 
(disk,, tape,, or punch queue),. 
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Figure 2.18. Relationship between POWER/VS and DGS/VS job accounting 
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Remote Job Entry (RJE) 



The POWER/VS RJE,BSC operations are perforrtied by phases IPW$$TM (mainline) and IPW$$MS 
(message handler) . IPW$$TM is entered from IPW$$I2 at F0WER/7S initialization time to 
save the RJE part of the generation table^ after which it returns control to IPW$$I2. 
IPW$$TM consists of POWER/VS subtasks and subroutines: the line initialization, the line 
manager, and the RJE,BSC reader/writer tasks, the remote access method (RTAM) 
subroutines, the subroutines to handle the RJE,BSC remote commands (* ..SIGNON, 
♦..SIGNOFF, * ..START, * ..STOP, * ..SETUP, and * ..GO), and the remote message writer 
subroutine. IPW$$MS contains the code of the POWER/VS message handler. 

Figure 2.19 shows the relationship between the RJE,BSC tasks described in the following 
paragraphs. 
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Figure 2.19. RJE, BSC Relationship 
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RJE.BSC LINE INITIALIZATION 

The line initialization task^ which uses the TCE of an RJE^BSC reader task, is attached 
by IPW$$GP when a line is started ty the central operator. It reserves real storage for 
a line control block (LCB) and buffer control area (EGA), and performs the initialization 
of these blocks, (For a detailed description of these control blocks refer to Section 5 
"Data Areas".) This task then activates the line manager and detaches itself. 

RJE^BSC LINE MANAGER 

The line manager task, which consists of a channel-end processor routine, an 
initiation/termination routine and an error logging routine, is attached during POWER/VS 
initialization. This task is activated whenever: 

• A channel end is detected, by the channel end appendage routine (IPW$$NU) . 

• A line is started, by the line initialization routine (IPW$$TM) . 

• A line is stopped, by the PSTOP and PEND processors (IPW$$GP) . 

The line manager continuously scans the EGAs and LGBs in the system as shown in Figure 
2.20, to detect which of the above events has caused this task to be activated. 
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Figure 2.20. Scanning the LGBs and EGAs 

When a channel end is detected, the channel-end processor is called. This routine 
consists of two sections. One section handles terminal responses during the GGW prepare 
sequence, which is used when the central system has messages or output to be sent to the 
terminal or when input is expected from the terminal. The other section handles terminal 
responses during the GGW read/write sequence, which is used to dynamically attach the 
reader/writer tasks when an ENQ/ACK is received from the terminal. (See Figure 2.21 for 
GGW sequences.) 

When a start/stop condition is detected, the initiation/termination routine is called. 
This routine resets the line status and puts the line in a dormant state. 

When a line error is detected, the error logging routine is called. This routine 
writes counter overflow records, unit check records, and end-of-day records to the DOS/VS 
recorder file on disk. 



The line manager only detaches itself when a 
EGAs have been released. 



PEND coirrrand is given, after all LGBs and 



^\^,y 
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c 



p J — . J. ^ 

I Prepare Sequence | Read Sequence- | Write Sequence | 
(. 4. 1 4 

I ENABLE (ENABLE (WRITE (text) | 

I NOP or WRITE ENQ/EOT or PREP | WRITE (response) | WRITE (end-of-text) j 

I READ (response) JREAD (text) |READ (response) | 

L J. JL J 



Figure 2.21, CCW Sequences 

RJE,BSC READER 

An RJE^BSC reader task is dynamically attached by the line manager when an ENQ is 
received from the terminal. The RTAM open subroutine is first called to put the line 
into read mode by changing the CC'W prepare sequence into a CCW read sequence. It then 
reads the first block of data, which is subsequently broken down into logical records by 
the RTAM get subroutine. Then the get subroutine automatically reads the next block of 
data into storage. When an RJE,ESC command is read at job boundary, it is processed by 
the RJE,BSC command processor routine. Logical data records are passed to the logical 
reader. After EOT, the RTAM close subroutine is called to put the line back into idling 
mode by restoring the CCW prepare sequence, after which the RJE,BSC reader task detaches 
itself. If EOT is not detected on a job boundary, however, the RJE,ESC reader task puts 
itself in the inactive state. 
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Figure 2.22. RJE,BSC Reader Flow 
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RJE,BSC WRITER 

An RJE,BSC writer task is dynairdcally attached by the line manager when an ACK is 
received from the terminal. If any messages are to be transmitted, the remote message 
writer subroutine is called first. If no messages are to be transmitted, the RTAM open 
subroutine is called to put the line into write mode by changing the CCW prepare sequence 
into a CGW write sequence. It then obtains logical data records from the logical writer 
and passes them to the RTAM put subroutine to be grouped into physical data groups. 
After being grouped, the data is written out to the terminal. At end of job, the RTAM 
close subroutine is called to write the last data buffer and to put the line back into 
idling mode by restoring the CCW prepare sequence. The logical writer is again called to 
delete the queue record, after which the RJE,BSC writer task detaches itself. If the 
output device remains ready, a new writer task is attached by the line manager after a 6 
to 9 seconds delay that allows the operator to start a reader task without interrupting 
an active writer task. If the output device becomes not ready during output processing, 
or when a forms change is required, the RJE,BSC writer task puts itself in the inactive 
state. 

A hot writer facility is provided if the logical writer passes a no-more-output 
condition* The hot list/hot punch switch in the LCB is turned off. This prevents a new 
writer task from being attached until the switch is turned on again by queue management. 
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Figure 2.23. RJE,BSC Writer Flow 
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MESSAGE HANDLER CIPW$$MS) 

This phase handles local as well as remote message requests. It is called by the message 
service routine in the POWER/VS nucleus whenever an IPW$WTO or IPW$WTR macro (local),, or 
an IPW$RMS macro (remote) is issued. 



For local message requests, information about the message to be iss 
calling routine in the message request word in the TCB. The messag 
and,, if necessary, truncated to the maximum of 72 characters. The 
scanned to determine whether any message modification is necessary- 
text is modified in the appropriate modification routine. Then a c 
(for an IPW$WTO macro),, or a console write operation followed by a 
IPW$WTR macro) is performed. For PUTSPOOL, GETSPOOL, and CTLSPOOL 
^^ characters of the message text are placed in the user's buffer a 
offset of 28 bytes- . 



ued is supplied by the 
e length is examined 
message text is 

If so,, the message 
onsole write operation 
read operation (for an 
processing,, the first 
rea at a displacement 



For remote message requests,, the function to be performed is indicated in the function 
indicator byte in the Remote Message Control Block (RMCB) . The following functions are 
performed: 

«« Queue remote messages ^ (BSC and SNA) to the virtual message queue 

® Delete messages from the queue when it is completely full with pending messages 

& Display ALLUSER type messages by passing them to the command processor 

« Delete ALLUSER type messages 

® Queue ALLUSER type messages to the ALLUSER type message queue 

» Delete BSC messages from the LCB subchain 

» Locate the first pending message ;for a specific BSC or SNA user 

« Delete SNA messages from the SNA delete subchain 

® Delete SNA messages temporarily by moving the entries from the SNA live subchain to 

the SNA delete subchain 

9 Add temporally deleted SNA messages to the SNA live siabchain 



RJE,, SNA 



I DESCRIPTION 



\ POWER/VS RJE„SNA provides support for the SNA terminals that use Synchronous Data Link 
Control (SDLC). The communication with the SNA logical units is accomplished by using 

I the VTAM access method at the API level. POWER/VS controls the SNA work stations through 
a logical connection. All physical connections within the logical path are controlled by 
VTAM and NCP. Since VTAM does some of its processing under the PIB of the DOS/VS 
application task, the DOS/VS supervisor handles VTAM page faults as if they were POWER/VS 
page faults. In order to minimize X-he effect of these page faults on non--RJE tasks,, 

I POWER/VS attaches a DOS/VS subtask under whose PIB VTAM processing can be executed. 

The POWER/VS RJE, SNA operations are performed by the following phases: 



I • 



I • 



IPW$$SN (SNA manager) 

IPW$$LH (SNA logon processor 1) 

IPW$$LN (SNA logon processor 2) 

IPW$$IB (SNA inbound processor) 

IPW$$OB (SNA outbound processor) 

IPW$$OC (SNA outbound compaction processor) 

IPW$$MP (SNA message processor) 

IPW$$LF (SNA logoff processor) 

IPW$$VE (VTAM exit routines) 



Figure 2.24 shows the POWER/VS RJE,, SNA interrelationship. 
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Figure 2.24. RJE.SNA Interrelationship 
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RJE„SNA FUNCTIONS 

Initialization 

If the central operator issues the PSTART coinmand for SNA,, the POWER/VS SNA manager is 
attached to the TCB chain and controls the activation of any inbound or outbound process 
related to a workstation and its associated sessions on a demand basis. The SNA manager 
attaches a DOS/VS subtask to the POWER/VS maintask in which the POWER/VS application 
opens the interface with the VTAM access method by issuing the OPEN ACB macro. The ACB 
points to an EXLST control block, which defines the asynchronous exit structure within 
the POWER/VS system to VTAM and consists of LOGON,, LOSTERM, TPEND and DFASY exits. After 
the interface to VTAM is opened any logon request to POWER/VS will be queued by VTAM. 
After the OPEN ACB request has been completed successfully POWER/VS issues a SETLOGON 
START macro to enable VTAM to schedule the POWER/VS logon exit routine,. 

L ogon Processing 

Upon a logon command from a logical unit VTAM schedules the LOGON exit. The LOGON exit 
routine queues the request with the LOGMODE table ehtry address. 

In a Multiple Logical Unit (MLU) environment, VTAM/NCP do not associate sessions within a 
work station concept. VTAM/NCP only see individual sessions between POWER/VS and the 
physical terminals,. Hence,, POWER/VS is responsible to associate sessions with work 
stations according to the DATA operand of the LOGON command. 

The logon routine No. 1 {IPW$$LH) in POWER/VS processes all logon requests in the logon 
queue,. For each logon request the routine performs the following functions: 

a. Utilizing LOGMODE table entry address and a logon workarea, it requests the user DATA 
and BIND parameters from VTAM issuing the INQUIRE SESSPARM ma^ro. 

b. It performs syntax checking of the REMID and verifies its existence as specified in 
the PRMT macro. 

c. It Checks the corresponding password if specified, 

d. It moves the 16 bytes of user information of the DATA into the session account record 
without validity checking. 

e,. It verifies that the logical unit' is authorized to log on with this REMID,, provided 
that an LU= (name,, . .. ) parameter has been specified in the PRMT macro. 

f. It validates the BIND parameters. 

In turn, the IPW$$LH routine checks whether or not any logical unit has been logged on 
with the same REMID. If no logical unit has as yet logged on with the same REMID, i.e., 
this work station is logging on its first session,, the routine initializes all relevant 
work station and session related control blocks for this REMID. 

If any logical unit has already logged on with the same REMID the routine verifies that 
this current logon request does not exceed the SESSLIM according to the specification in 
the PRMT macro. The ^routine initializes the relevant session related control block,, if 
SESSLIM is not exceeded. Else it rejects the logon reuqest,. 

When the control blocks have been initialized the routine causes the logon No. 2 routine 
(IPW$$LN) to be attached,, and it proceeds processing the next logon request from the 
queue. 

The IPW$$LN routine completes processing the logon request for this session. It issues 
the OPNDST ACCEPT and SESSIONC SDT macros to VTAM and issues messages to the remote and 
central operators. 

The Logon request may be rejected for several reasons: 

a. Invalid user logon parameters,, whereby VTAM sends a message to the central operator^ 

b. System error (non-zero return code from VTAM). 
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c. The BIND parameters are not accepted. . 

■ ■ ' . . /^ v.y 

d. The number ot logon commands for a given workstation exceeds the number specified by 
the SESSLIM parameter in the PRMT generation macro. 

e. The name of the logical unit logging on with a given REMID is not associated with the 
REMID specified in the PRMT macro. 

Note: This correlation of LU name and REMID is tested if and only if at least one LU 
name has been specified. 

f. ^ The INQUIRE or OPNDST macro to VTAM was not successful. 

g. A GETVIS failed, 

h. The logon request provides an invalid REMID or password. 

POVvER/VS then issues a CLSDST to VTAM resulting in a network procedure error being sent 
to the work station. Messages are sent to the central operator giving a logon reject 
reason code: 

•1V0 6I UNABLE TO LOGON luname RC-=' or 

'1V26I INVALID REMID,, PASSWORD,, OR LUNAME RC=* 

The BIND Format 

The BIND parameters - exchanged between POWER/VS and SNA terminals are detailed in the 
DOS/VS PQWER/VS Installation Guide and Reference ,, in the Appendix describing "RJE, SNA I/O 
Specifications." POWER/VS is flexible in its BXND requirements. Each BIND parameter 
affords one of the following characteristics: 

a» ignored parameter (I) / 



» enforced parameter (E) 

® mandator parameter (M) 

® variable parameter (V) 

Ignored parameters are neither tested nor modified by POWER/VS. Enforced parameters are 
dictated by POWER/VS on the secondary logical unit,. Mandatory parameters are tested,^ and 
if incorrect, the logon request is rejected. The variable parameters are copied, 

H ost-Work Station Communication 

Logical records are grouped into RU's which are logically grouped into chains. Output 
related to one POWER/VS queue entry (job or segment) is sent as one chain lonless 
interrupted by an inbound flow or an outbound message. An outbound job is always sent as 
a DS (data stream). Messages are sent as an only-chain. 

Input related to one POWER/VS queue is not related to a chain by POWER/VS. POWER/VS only 
identifies job boundaries according to POWER/VS-JECL or DOS/VS--JCL statements with the 
exception that an end bracket forces End o% JOB (EOJ)„ if no valid £>OWER/VS job delimiter 
was found. It is the option of the work Station to associate jobs and chains if this 
association simplifies ERP (error recovery procedures) at the work station. 

POWER/VS Supports all three SNA function management headers for outbound,, i.e.,, FMH1„FMH2 
a,nd FMH3., but only FMHl for inbound. Concatenation of FMH'S is not supported. If 
POWER/VS receives an FMH with the concatenation bit bn„ it returns an exception response. 

Function Manaqem.ent Header Type 1 (FMHl) .. POWER/VS supports the standard 6--byte FMHl for 
device selection and delimiting data set operations. ,4" 



The Figure 2.24A details the FMHl format layout. 
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Figure 2.2 4A. FMHl Format 

Note 1: The data stream selection bits are used in combination. The valid combinations 

Resume suspended data stream (RDS) 

End current data stream (EDS) 

Begin data stream (BDS) 

Begin and end data stream (BEDS) 

Suspend current data stream (SDS) 

Abort (abnormally end) current data stream (ADS) 

Reserved 

Reserved. 

The following should be noted: 

1. With the resumption of a suspended outbound data stream, POWER/VS will not change any 
of the FMH options selected in the original FMH. 

2. An FMH may exist in an RU only at f irst-of-chain (FC) or only-chain (OC) . The 
presence of an FMH is signaled by the format indicator bit in the request header. If 
data is received with no FMH where an FMH is expected, the default FMH applies as in 
Figure 2.2aB. 

3. When the data stream selection bits are set to B'Oll' the entire data stream is being 
sent within one chain, including the FMH. Print and card media output data are 
initiated by only-chain FMH's indicating BDS, followed by chain (s) of data, and 
terminated by an only-chain FMH indicating EDS. 
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An FMHl (BDS) is sent prior to^ and an FMHl (EDS) after, each job output or segment. 
FMHl (BDS) is sent after FMH3. 



J. -p 

Byte I Bit 



Name 



Content | Description 
+ , 

X'06' [Length of FMHl 



H- 



0-7 



length 



-^ 





1 

2-7 



FMHC 

reserved 

TYPE 



B'O* 
B'O' 
B'OOOOOl" 



I Concatenation not supported 

I 

I Type 1 FMH 
.+ .. 



-H 



1-3 
4-7 



DEMAND 

SELECT 

MEDIA 

LOGICAL 

ADDRESS 



B'O* I Not supported 
B'OOO' ] CONSOLE 
X'O' list console 




1-7 



STACKREF 



B'O' 
B'OOOOOOO' 



! Stack reference indicator 



!5 



0-2 

3 

4 

5 

6 

6 

7 



DS sel. |B"011' I Begin and end of data stream 

DST I B'O* I Basic exchange not supported 

reserved |B' 0' | 

CMI I B'O* I No compression 

CPI I B'O' [Compaction not supported 

CPI I B'O' [Compaction not supported 

reserved j B* 0' | 

^ +.-^ ^^^ « . „ 

|ERCL IX'OO' [Basic exchange record length, not supported 

L X. — ■ X . 



! 
J 



[0-7 
-X 



Figure 2.24B. Default FMHl 



y 



Function Management Header Type 2 (FMH2) . The FMH2 represents the peripheral data set 
information record (PDIR). It carries information relative to the destination selected 
by FMHl. POWER/VS only supports FMH 2 outbound, but not inbound. 

The format of the FMH2 is shown in Figure 2.24C. 
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TYPE . 
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DATE 



X'44' 
B'O* 

B'OOOOlO' 

X'Ol" 

X'OO* 

MM/DD/YY 



Length of FMH2 

No concatenation 

Reserved 

FMH type 2 

PDIR 

Ordinary data set 

Date of queue set creation, EBCDIC characters in the 

£orm MM/DD/YY provided by POWER/VS internally,. 



H 



I- f 

20-27 



TIME 



HH.MM. SS 



Time of queue set creation. EBCDIC characters in the 
form HH.MM, SS provided by POWER/VS internally. 



H 



i- + 

28-35 



FORMS 



C'ccccbbbb* 



Forms name. EBCDIC characters in the form 
C*9cccbbbb'. Default is all blanks. The forms name 
can be provided only by the * $$ LST or * $$ PRT JECL 
statements. 



H 



I- + 

36-43 
44-51 



FCB 



C'cccccccc" 



FCB name (1-8 characters). EBCDIC characters in the 
form C'cccccccc' left justified. , Default is all 
blanks- The FCB name can be provided only by the * 
$$ LST or * $$ PRT JECL statements,. 



-i 



h + 

52-59 



TRAIN 
COPIES 



C'bbbbbbblp' 
C cccccccc' 



(Not supported) 
Copies (1-8 characters). Indicates the number of 
additional copies,, i.e.,, zero means one copy. EBCDIC 
characters (digits), right justified,, with leading 
zeros Suppressed except low order digit* The maximum 
number of additional copies is 98. The number of 
additional copies plus one can be provided by the * 
$$ LST or * $$ PRT JECL Statements or by means of the 
PALTER (central operator) or ALTER (remote operator) 
commands. 



F + 

60-67 



t X- 



VOLIO 



C cccccccc" 



Volume of I/O. EBCDIC characters (digits) in the 
form C'ccticcccc' right justified with leading zeros 
suppressed. If printer selected the field indicates 
the number of expected print lines. Information 
provided by POWER/VS internally,. 



H 



JOB NAME 



C cccccccc' 



Job name. EBCDIC characters in the form C'cccccccc' 
left justified. The jobname can be provided by the * 
$$ LST or * $$ PRT JECL statement. Default is 
generated to AUTONAME by POWER/VS. 



where.: b= blanks 

c=EBCDIC characters 

Figure 2.24C. FMH 2 Format 

The FMH2 is sent as an only- chain in DS state after FMHl has been sent, provided that 
the PDIR bit in the BIND parameters was turned on at logon time of the session.. If the 
PDIR bit is off the SETUP/GO procedure will be performed. 

The PDIR is always sent if the BIND indicates so, regardless of whether or not forms 
change is required. Without, PDIR indicated in BIND the SETUP/GO procedure is performed 
only if forms change is required. 
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Fijnction Management Header Type 3 (FMH3) > The FMH3 carries information relative to the 
entire session. Type 3 information applies to all destinations reached through this 
session. The FMH3 is sent as only-chain and it is not chained with another FMH, nor 
does the RU contain any other data. POWER/VS supports only outbound FiyiH3 . If POWER/VS 
receives an inbound F^MHS it returns an exception response. 



V_:>^ 



The format of the FiyiH3 is shown in Figura 2,2 4D. 
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|0 
|1 
11 
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I 2 
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1 a~n 
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I Bits 



I Name 
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I 0-7 

|0 

11 

12-7 
I 0-7 
iO-7 



! LENGTH 

IPiyiHC 

I Reserved 

jTYPE 

I FUNCTION 



i (Note 
1 B • • 



1) 



B' 000011' 
jX'02' 



1 MASTER NQ] 3-16 

i TABLE 1 (Notes 1 



I Length of FMH3 
I No concatenation 

I 

[Type 3 FMH 
I Compaction table 
I No. of master characters 
2) I Compaction table characters 



Figure 2.24D. FMH3 Format 

N ote 1 ; Length is dependent on length of the compaction table. It can be calculated by 

length = 4 + 256 - (m x m) for m < 16 
length = 4 + 16 for m = 16 

where m is the number of master characters. 



Note 2 ; The compaction table is transmitted in row major order, starting at the bottom 
row and omitting the cells in the upper left corner m by m matrix,, where m is the number 
of master characters. The cells in the sub matrix represent compacted characters. 

The FMH3 including length indication is generated by the PCPTAB macro. 



'V.....X' 



An FMH3 is sent to the secondary logical unit whenever a job is to be transmitted 
outbound in compacted form using a compaction table other than the one currently valid 
for the session. The FMH3 is always sent as only-chain, without data, and between, DS 
state. The FMH 3 RH may or may not indicate begin bracket depending on whether or not the 
session is already in bracket state. 

Initiation of Data PrOci:essinq 

D ata Inbound Process ing. An inbound processor task is attached for a given session by 
the SNA manag:er in the following cases: 

a« A VTAM RECEIVE ANY is satisfied: 

The SNA manager determined the session on which an inbound flow is to be expected by 
means of a pointer in the user field of the RPL. It then attaches an inbound 
processor, and reissues RECEIVE ANY to. allow input from other sessions to be 
accepted. 

b. An inbound flow is interrupted fpr an inbound message: 

The inbound processor being interrupted posts the SNA manager which attaches a second 
inbound processor for this session. 

c. An outbound flovy? is interrupted for an inbound flow or message: 

The outbound processor being interrupted posts the SNA manager which attaches an 
inbound processor for this session and reissues RECEIVE ANY. 



In all three cases the inbound processor issues RECEIVE SPECIFIC. It verifies whether or 
not the device (RDRl or console) selected by FMHl (implicit or explicit) is already in 
use. If in use it rejects the inbound flow. 

If RECEIVE ANY is satisfied on all sessions at approximately the same tinae, an inbound 
processor is attached on each session, whether free or involved in an outbound operation. 
Each inbound processor performs the verification described above upon reception of an 
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FMHl, This verification results in rejection of all simultaneous inbound flow requests,, 
with the exception of one reader and one console at the maximum. 

Data Outbound Processing . An outbound processor task is attached for a given session by 
the SNA manager in the following cases: 

a. Outbound Data. 
When a job is available in an output queue (list or punch) of a given class with a 

I given REMID, the queue management (IPW$$NQ) routine of POWER/VS scans the control 
blocks for a match of the REMID. When the REMID is found the routine scans the 
classes of all outbound devices for this REMID. These classes are assigned to the 
devices by means of the START command. When a match is found, and if the device has 
been started, the routine flags the device and posts the SNA manager. 

The SNA manager finds the flagged device and searches for a free session. If a free 
session is found the SNA manager attaches an outbound processor which starts 
processing the job output until the output queue is empty. When the queue is empty 
the outbound processor resets the device flag,, posts the SNA manager and detaches 
itself. 

The SNA manager does not take further action if no free session is found. It will 
repeat the attempt when it is posted again,, e.g.,, when a processor is detached. 

b. Outbound Message,. 
Outbound messages are queued by the message service routine CIPW$$MS). Whenever the 
routine queues a message for a given REMID it posts the SNA manager. The SNA manager 
searches a free session to the workstation identified by the REMID. If a free 
session is found the SNA manager attaches the message processor which sends the 
message to the workstation. 

If no free session is found the SNA manager searches a session involved in an 
. outbound flow. The search begins for a session which is waiting for a GO command or 
RESTART following intervention required. If not found,, then the search continues for 
some session which is transmitting,. If found, it flags the associated control block 
which causes the outbound processor to suspend. Upon suspension the SNA manager 
attaches the message processor. 

No action is taken by the SNA manager if no session involved in an outbound flow is 
found. The SNA manager will repeat the attempt when it is posted again,, e.g., when a 
processor is detached. 

Once attached, the message processor transmits all messages queued for a given REMID and 
detaches,. 

Interruption of Data Processing 

Interruption Of Data Outbound . The interruption of the outbound processor can be caused 
by the following conditions: 

a. A SIGNAL from the work station has been received. 

The outbound processor forces the termination of the current chain, sends an FMHl 
with suspend DS and a change direction indication to the logical unit. It then posts 
the SNA manager which attaches the inbound processor. 

b. A message is pending. 

The outbound processor forces the termination of the current chain, sends an FMHl 
with suspend DS to the logical unit,, and posts the SNA manager which attaches the 
message processor. 

Interruption Of Data Inbound . Interruption of an inbound processor receiving card data 
is accepted anytime when the logical unit has a message to send. 

The interruption must be indicated to the inbound processor by an inbound FMHl with 
^/ suspend DS. The suspended inbound processor will then post the SNA manager which will 

attach a second inbound processor to receive messages. These messages are treated as 
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commands. Upon reception of an FMHl with resume DS , the interrupting inbound processor /^ \ 

will detach,, the suspended inbound processor will resume the DS,, and normal inbound flow 

can continue. X >" 

Inbound interruptions for outbound data are not supported. 

Protocols 

Half -duplex, flip-flop mode protocols are employed. Only one data stream at a time is 
allowed per session and contention is resolved by the use of SNA brackets. 

T ermination 

Session Termination . The termination of a session is requested by the remote operator 
either by issuing the logoff request through VTAM, or by submitting a SIGNOFF command 
(from card or via the console) in the inbound data flow. The logoff request may be an 
unconditional logoff in which VTAM breaks the session and notifies POWER/VS through the 
LOSTERM exit. If the remote operator issues a conditional logoff VTAM notifies POWER/VS 
also through the LOSTERM exit,, but VTAM does not break the session. The SIGNOFF command 
is passed via the normal inbound data stream directly to POWER/VS where it is handled as 
a conditional logoff request for all sessions of a given workstation. 

The work station may logoff any individual session within the MLU concept. The logoff 
may be conditional or unconditional. The SIGNOFF command causes logoff of all sessions 
of the work station conditionally. 

POWER/VS handles the unconditional logoff as an emergency stop which means that the 

termination routines are entered without checking any internal job boundary state. In 

this case the current reader job entry will not be added to the queue. The conditional 

logoff will be interpreted as a request for an orderly deactivation of the current 

session. In this case the termination routines will be entered only at job boundary x^ 

time,, when processing of the current job entry is completed. 



After the active processors have been terminated, either normally or abnormally,, the SNA 
manager activates the logoff processor which sends a message to the work station and 
finally issues a CLSDST to terminate the session. In an MLU environment a SIGNOFF causes 
termination session- by- session at job boimdary times. 

Session termination can be causes by the central operator either by means of the PSTOP 
command or, in case of emergency,, by issuing the VARY NET, INACT, I„ ID=luname command. 
VTAM notifies POWER/VS in the LOSTERM exit. Because VTAM does not allow any 10 request 
to be issued, POWER/VS handles this termination type similar to an unconditional logoff. 

Application Termination . The central operator may cause RJE,SNA Shut-down either through 
POWER/VS central operator commands (e.g.,, PSTOP or PEND) or through VTAM operator 
commands (e.g.., HALT). 

Refer to DOS/VS POWER/VS Installation Guide and Reference , GC33-6048. 

RJE,,SNA ROUTINES 

Figure 2.24E briefly describes each of the routines used to support RJE, SNA. The Figure 
2.24F further describes the control blocks and work areas used to aid execution. In 
addition,. Figure 2.24H illustrates the scheme of chaining the control blocks. 

An overview of the sequence of routine execution and events is provided by Figure 2.24G. 
This figure should be used along with Figure 2.24E to better understand the RJE, SNA 
architecture. 



V „ 
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Routine 



Called/ 
Attached by: 



Returns, to: 



Function or Notes 



H 



IPW$$IB- 

Inbound 

Processor 



IPW$$SN 



IPW$$NU 



Issues RECEIVE Specific request to VTAM to receive 
data and then deblocks the data for Spooling 
by IPW$$LR<. 



Processes remote operator commands: 

(> START 

« STOP 

» . FLUSH 

« RESTART 

® SETUP 

o GO 

SIGNOFF 

and transfers all other, commands to IPW$$ClP for 
processing- 
Posts the outbound processor command folio v^ing GO,, 
or RESTART when intervention is required. 

Posts the SNA manager. 
Detaches itself. 



h 



IPW$$LF- 

Logoff 

Processor 



IPW$$SN 



IPW$$NU 



Logs off a logical unit using the VTAM macros 
SESSIONC and CLSDST. 

Sends message "1V12I LOGOFF COMPLETED" to the 
remote terminal and then sends the central 
operator the message "IVllI REMOTE rrr LOGGED OFF 
FROM POWER ON luname." 

Posts the SNA manager. 

Detaches itself. 



h 



-H 



IPW$$LH 
Logon Pro- 
cessor No.l 



IPW$$SN 



Completes SNA control block construction 
(SUCB-, LUCB and WACB) . 



Checks LOGON request and LU BIND parameters for 
validity. 

Sets an indicator for IPW$$SN to attach logon 
processor No. ,2 (IPW$$LN) . 

Posts the SNA manager. 

Detaches itself. 



—.J 






Figure 2.2aE. Description of RJE,,SNA Routines (Part 1 of 3) 
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I Routi ne 
I 

I IPW$$LN~ 
! Logon Pro- 
j cessor No. 2 



+~ 



H— ' 

I IPW$$MP- 
[Message 
I Processor 



H- — ^-— 

1IPW$$0B- 
I Outbo und 
j Processor 



1 IPW$$OC- 
1 Outbound 
1 Compaction 
\ Manager 



I IPW$$SN~ 

I SNA Manager 

I 

1 



H— 

1 IPW$$SN- 
I Segment 
1 SUBTASK 



Called/ 1 Returns 
Attached by : j 

IPW$$SN iIPW$$NU 

! 



IPW$$SN 



I 

! 



to: I Function or Notes j 

1 ^ . ^ .. _ _^ . . \. ^_ „ ' 

[Establishes SNA session and starts ,data traffic j 

jwith VTAM macros CPISIDST and SESSICNC, 1 



i Prints message "1V09I RKMOTE rrr LOGGED ON TO 
1 POWER ON luname" at central operator console and 
j then queues the same message for the remote 
|terminal,to be sent by the message processor 

1(IPW$$MP). 

I ^ 

[Posts the SNA manager, 

! 

I Detaches itself. 



|IPW$$NU (Transmits messages in message queue using 

jVTAM macro SEND. 
I 
1 
1 Detaches itself. 



lPW$$SN as 1IPW$$NU 
LSTn or PUN i 
task ! 



[Obtains job output data, from spool file and 
[transmits data to the LU using the VTAJXI macro 
[SEND. The follomng intermediate steps occur: 

i 

|» Obtain spool file through IPW$$LW. 

1® Create Function Management Headers (FMH) . 

1 » Compress and compact if required. 

1 ® Pack data into request units CRU)„ 

I 

[Wait on GO posting frbm IPW$$IB if SETUP remote 

[command issued. 



"-i 



IPW$$OB 



I IPW$$OB 



I Post the SNA manager and detaches itself, '\ 

[Creates and updates COCB(s) and loads compaction j 
[table phases into . GETVIS area. [ 



-+- 



IPW$$CP 



j IPW$$NU 



IPW$$SN- 
IN IT 



-+- — 

[DOS/VS 

i 



[Sets up fol levying ECBS in the TCB of IPW$$SN: 

[• VTAM RECEIVE any EC.B 

]« Work ECB for RJE,vSNA posting of IPW$$SN. 

I 

[Attaches IPW$$SN~ Segment SUBtASK which calls 
1IPW$$VE-Segment INIT (see below), 

I 

[Issues VTAM RECEIVE macro. Prints central 
j operation message 
|"'VOai RJE,SNA STARTED" 

I 

I Waits on ECB posting. 



H 



J when called the first time at RJE,SNA start-up 
jtime, it calls the IPW$$VE-Segment • INJT and J 

[enables communication through VTAM with SETLOGON [ 
[macro. Then posts IPW$$SN ECB and POWER/VS master J 
[ECB,' and waits on posting by IPW$$SN, [ 

i I 

[At termination time, the VTAM macro SETLOGON ] 

IQUIESCE is called to halt further LOGON requests,, j 
.j.-.-^. — „-. _-.- .-«. .^^ ^ , . J 



Figure 2.2aE, Description of RJE^SNA Routines (Part 2 of 3) 
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I Routine 



h 



-+- 



Called/ 
Attached by: 



Returns to: 



Function Or Notes 



-i 



h 



IPW$$SN- 

Segment 

MAIN 



Posted by: 
o VTAM due 

to: 

RECEIVE • 
Any input 

VTAM exits 
« POWER/VS 

routines: 
IPW$$AQ 
IPW$$CP 
IPW$$IB 
IPW$$LH 
IPW$$LN 
IPW$$,MS 
IPW$$OB 



IPW$$NU 



After VTAM posting due to SNA line activity, 
a RDR task is attached which causes IPW$$IB 
to execute. 

After posting from other POWER/VS routines^ a 
scan of the work station control blocks (SUCBS) 
and logical unit control blocks (LUCBs) is made. 
If any found to be active, the appropriate 
processor tasks are attached: 
• LST or PUN tasks (IPW$$0B) 
» Messages (IPW$$MP) 

Then a loop back if made to wait en further 
posting. 



IPW$$SN- 
Segment 

TERM 



IPW$$SN- 

MAIN 



IPW$$NU 



Frees certain work areas and control blocks. 
Prints message "1V05I RJE„SNA TERMINATING." 



Detaches IPW$$SN task. 



IPW$$VE- 

Segment 

LOGON 



h 



VTAM 



VTAM 



Creates and chains control blocks,, used at logon 
time,. 

Posts IPW$$SN work ECB and POWER/VS master ECB. 



IPW$$VE- 

Segment 

INIT 



h 



IPW$$SN- 
SUBTASK 



IPW$$SN- 
SUBTASK 



Inserts addresses of VTAM exits in the ACE exit 
list. 



"H 



IPW$$VE- 

Segment 

DFASY 



F- 



VTAM 



VTAM 



If request to interrupt data flow,, then the 
signal received indicator is set in the LUCB 
of the LU. 

If request to shut down, then stop session 
indicator is set. 

Posts IPW$$SN work ECB and POWER/VS master ECB. 



-H 



IPW$$VE- 

Segment 

TREND 



I- 



VTAM 



VTAM 



Sets SNA stop code in SNCB. 

Post IPW$$SN work ECB and POWER/VS master ECB. 



IPW$$VE-' 

Segment 

LOSTERM 



VTAM 



VTAM 



Sets on the stop session indicator in the LUCE 
of the LU. 

Posts IPW$$SN work ECB and POWER/VS master ECB. 



^P**%k^ 



Figure 2. 24E. Desc'ription of RJE,,SNA Routines (Part 3 of 3) 
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1 1 
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1 
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1 Blocks/ 


i 
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1 Stored 


[Purpose/General Contents ] 
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[at: 
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JCAT 


|At POWER/VS 


|At POWER/VS! IPW$$IR 


I Real 


j Pointers to modules and majorj 


1 (Control 


I Initialization! Termination j 


1 storage 


[control blocks, [ 


1 Address 


1 


1 1 


1 area 


! 1 


1 Table) 


1 


! i 




1 1 


1— ^ 


-i 


_l — _ + 


-+~ 


>+ .„ ^ 


ISNCB 


|At POWER/VS 


lAt POWER/VS |IPW$$IR 


j Fixed 


jRJEf^SNA control block. ) 


i (SNA 


j Initialization] Termination! 


[real 


! 1 


[Control 


1 


1 1 


j storage 


1 1 


1 Block) 


1 


1 1 


[ area 


1 1 


J. ^ 


-+ 


_+ + 


-+ 


.^+ ^ 


|COCB 


!At time of 


jAt RJE.SNA |IPW$$OC 


1 GETVIS 


1 contains compaction table [ 


1 (Compaction] first compac- 


1 Termination! 


[area 


[names, pointers and status. | 


[Control 


I tion table 


1 {IPW$$SN) 1 




! 1 


1 Block) 
i 

i 
1 
! 

L . 


! us age 

1 

1 

1 

! 

„J , , 


1 ] 
1 1 
i 1 
1 1 
i 1 

_x , J 




[One COCB is generated for j 
[each 64 default tables. [ 
[First is loaded with a ] 
[default table name specified j 
|in PRMT macro. | 
._i^ ^^^ . J 


Y 


-^ 


_^ ^ 


""if ■""*""" *"' "" "" ■~'"' 


.^^ ^ 


jLRCB 


JAt first LU 


[When (last) | IPW$$VE 


1 GETVIS 


[Used for LOGON processing. [ 


1 (Logon 


! LOGON 


1 LOGON 1 


[area 


[Consists of a header plus j 


1 Request 


1 


[processed | 




1 LRUB • S . 1 


j Control 


1 


! 1 




1 1 


1 Block) 

L 


1 


1 1 

_j J 


.1 


1 1 


|. 


— ^— —.——.—.———— •—-. 


T T 


T 




ILUCB 


[Space reserved) At work |IPW$$LH 


[GETVIS 


[Contains information required) 


1 (LU 


|at logon of 


[station \ 


j area 


[for LU session, e.g. variable} 


1 Control 


[first LU of 


1 logoff time| 




[BIND parameters. Created by [ 


1 Block) 

! 

1 

L 


[work station 

1 

1 

1 


1 (IPW$$LF) 1 
1 1 

1 1 

_j i. 


_j ^^ 


1 copying the logon LUCB on to the 
(One is created for each LU | 
1 logged on. j 

X — — — J 


r 


T 


-- 1. ^ 


-^ 


^ — - -^__ — _ _ — ^ 


j Logon LUCB 


JAt LOGON of 


jAt RJE^SNA 1IPW$$VE- 


-] GETVIS 


[Contains information required) 


1 


1 first LU of 


1 Termination) Segment 


1 area 


[for LU session. Used as j 


I 


jwork station 


1 (IPW$$SN) 1 INIT 




[work area during logon ] 


1 

1- 

ISUCB 


1 

-+ 

1 Space reserve 


i 1 
^1 « 1 

d|At LOGOFF 1IPW$$LH 


[GETVIS 


[processing. | 
^1 ^ 

[Contains information j 


1 (SNA 


JAt LOGON of 


[of last LU [ 


1 area 


[pertaining to the work f 


lunit 


1 first LU of 


j of work 1 




[station of two types: j 


! control 


jwork station 


[station ] 




1 a) General information,, for J 


1 block) 

1 

i 

1 

1 

1 

1 

1 

! 

1 


1 
1 
1 
1 
1 
1 
1 
1 
1 
! 


1 ! 
1 1 
1 1 
1 1 
1 1 
1 1 
1 1 
1 1 
1 1 
1 1 




1 example: REMID,, SESSLIM-. j 
1 b) Device information for [ 
1 LSTn, PUN, RDR and [ 
1 Console,, for example: [ 
[ class,. 1 

1 1 

[Created by copying the LOGON ] 
(SUCB onto the reserved SUCB i 
[area. One is created for | 
1 each work station logged on. ] 


L _ 


L 


.«.X JL 


-X 


—X . J 



./-^"^x 



..y 



\_^ 



Figure 2.24F. Description of RJE, SNA Control Blocks and Work Areas (Part 1 of 2) 
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RJE,SNA 
Control 
Blocks/ 
Work Areas 



When 



Created: 



Created 
j Freed : 



Stored 
by: 



Purposey 
at : 



/General Contents 



Logon SUCB 



At logon of 
first LU of 
work station 



At RJE.SNA 
Termination 



IPW$$VE- 

Segment 

INIT 



GETVIS 
area 



Used as a work area during 
LOGON processing. 



WACB 



LOGON WACB 



RMCB 
(Remote 
Control 
Block) 

LRUB 

(LOGON 

Request 

Unit 

Control 

Block) 



« WACB for 
inbound 
int€5rruption 



WACB for 
LU inbound 
data 

WACB for LU 

outbound 

data 

At LOGON of 
first LU of 
work station 

POWER/VS 

Init i al iz at ion 



At LOGOFF 
of last 
session 
of work 
station 
At LOGOFF 
of LU 



At LSTn/ 
PUN task 
termi- 
nation 



IPW$$LH 



IPW$$LH 



IPW$$OB 
IPW$$MP 






At RJE^SNA 
Termination 



1PW$$VE- 

Segment 

INIT 

POWER/VS |IPW$$IR 
Termination 



GETVIS 
area 



GETVIS 
area 



GETVIS 
area 



+ 

GETVIS 
area 



+ 

GETVIS 
area 



Contains VTAM RPLs, RU 

buffers and some BIND 

information- 

One exists for each SUCB for 

inbound console data; 

another exists for each LUCE 

logged on for inbound; 

and another exists for each 

LUCB logged on during 

outbound data or 

message handling. 



Used as work area for LOGON 
processing 

Contains information from 
the PRMT macro. 

I 






I- 

At LOGON time 



After LOGON 
processing 
by IPW$$LH 



IPW$$VE- 

LOGON 

Exit 



GETVIS 
area 



Contains LOGON request 
information. 



Figure 2.24F. Description of RJE, SNA Control Blocks and Work Areas (Part 2 of 2) 
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RJE,SNA - Initialization 



PSTART RJE, SNA 



Central 
Operator 



"1V04I RJE, SNA 
STARTED" 


IPW$WTO 


Central 
Operator 


'k 


W 







i 



IPW$$CP 



Attach 

RJE, SNA 
task 



IPW$$SN 



Attach 
DOS/VS 
subtask 



Ready for 
traffic 



Wait for 

ECB posting 



DOS/VS 



iPW$$SN 
(SUBTASK) 



Initialize 

VTAM ACB 



Open ACB 

Enable 
session 
logon 



Post ECBs: 

• IPW$$SN 

• POWER/VS 
master ECB 



DOS/VS 



RECEIVE Any 



VTAM 



V.,^ 



IPW$$VE 
(INIT) 



Construct 
VTAM ACB 
Exit List 



SETLOGON Start 



v./ 



VTAM 



Figure 2.24G. RJE, SNA Execution Flow (Part 1 of 9) 
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RSE,SNA ~ Logon 



(Logon) 




IPW$$VE 
LOGON 
Exit 



Set indicator 
to activate 
IPW$$LH 

Post ECB 
IPW$$SN 

Post EGB 
POWER/VS 
nriaster ECB 



VTAIVI 



IPW$$SN 



Attach 
IPW$$LH 

Wait on ECB 
posting 



IPW$$LH 



Create CBs, 
SUCB, LUCB, 
WACB 

Do validity 
checking 
of logon 
request 

Indicate to 
attach 
IPW$$LN 

Post ECB 
IPW$$SN 

Detach 



(cont.) 



Figure 2,24G. RJE,SNA Execution Flow (Part 2 of 9) 
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(cont.) 








IPW$$SN 






Attach 
IPW$$LN 
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ECB posting 
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LU session 


OPN 
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r 




^ 


1 




VTAM 




Start 
message 
flow 










SESS 


ONC 






1 




VTAM 


"1V09I REMOTE rrr 
LOGGED ON TO 


Send msg. 
to central 
operator 
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logon msg. 
for remote 
terminal 

Post ECB 
IPW$$SN 

Detach 






POWER ON luname' 


IPW$WTO 
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Operator 














IPW$RMS 






i 








IPW$$NU 








i 








IPW$$MS 










Add msg. 
to virtual 
queue 

Post ECB 
IPW$$SN 










t 










IPW$$SN 






Attach 
IPW$$MP 

Wait on ECB 
posting 






I 






IPW$$MP 
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SE 


ND < 






1 




VTAM 
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Figure 2. 24G. RJE,SNA Execution Flow (Part 3 of 9) 
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RJE,SNA- Receive 
Console/Card Reader Data 



C 





VTAM 




Post 


■ 
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ECB of 


r 


1 

1 


IPW$$SN 




^ 








IPW$$SN 






Attach 






IPW$$IB 
Read input 


RECEIVE Any 






i 




VTAM 


Wait on 










ECB posting 






y 


f 






IPW$$IB 






Open 






IPW$OLI 


IPW$$LR 
interface 










^ 


r 








IPW$$NU 










Receive and 

deblock 

input 








RECEIVE 


specific 






1 




VTAM 




Process 










commands 






• START 






• STOP 






• FLUSH 






• RESTART 






• SETUP 






• GO 






• SIGNOFF 






all other 




IPW$ICP 
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i 




to IPW$$CP 
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1 
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It.) 










Figure 2.24G. RJE.SNA Execution Flow (Part 4 of 9) 
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IPW$$OB 



IPW$PLR 



IPW$$LR 



Process 
data input 
with 

JECL/JCL 
cards 

Write data 
records to 
Data File 

Create Queue 
File entry 



IPW$CLI 



IPW$$NU 



IPW$$1B 
(cont.) 



Post ECB 
IPW$$OB 
if GO 
command 
following 
SETUP 

Spool input 
(logical) 
card reader 
to disk 



Close 

IPW$$LR 
interface 



Reset VTAM 
to RECEIVE 
Any 



Post ECB 
IPW$$SN 



Detach 
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LUCB for 
work 



\^_J 
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VTAM 



Figure 2.24G* RJE,SNA Execution Flow (Part 5 of 9) 
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ECB Posting: 
IPW$$IB 
IPW$$MP 
IPW$$SN 



IPW$GLR 
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Read data 
from Data 
File 
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Queue File 
Data File 
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data into 
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Figure 2.240. RJE^SNA Execution Flow (Part 7 of 9) 
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RJE,SNA - Logoff 
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Post ECB 
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stop session 
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IPW$$SN 

Post ECB 
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LUCB for 
work 
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session 
shutdown 
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(cont.) 



Figure 2.24G. RJE,SNA Execution Flow (Part 8 of 9) 
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Figure 2.24G. RJE^SNA Execution Flow (l>art 9 of 9) 
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PA.GE FAULT APPENDAGE 



If a page fault occurs,, normally the partition is placed in a wait state,, until the 
processing of the page fault is completed. 

When a page fault overlap appendage linkage is established,, the partition remains 
dispatchable in order to enable selection of another private task (within the partition) 
under control of its private multitasking routine. 

The appendage routine for the POWER/VS partition is entered from the page manager routine 
in the supervisor on two conditions: 

• the partition sustains a page fault (pre-processor) 

• handling of a page fault is completed (post-processor) . 

The page fault pre-processor will take the following actions: 

1. Save the task status, address of next instruction in PSW„ and general registers 
(taken from the partition save area),, in the TCB, because of page handling overlap by 
the supervisor later on. 

2. Simulate a IPW$WFP macro instruction (put TCB in P state),. This action is 
transparent to the task management routine. 

r ^\ 

3. Change the address of the next sequential instruction in the PSW to the entry of V^ 
POWER/VS task management,, because of page handling overlap by supervisor later on,. 

4. Queue the page fault request within an internal queue (in TCB chain),, unless no page 
fault is being currently handled for the POWER/VS partition. 

5. If no page fault is currently handled the request is returned directly to the page 
manager routine in the supervisor. If a page fault is currently handled,, a request 
of zero is returned to the page manager,. 

The page fault post- processor will take the following actions: 

1. Post the task,, for which the page fault handling is completed,, dispatchable (in TCB 
reset P state),. 

2. Post the partition dispatchable (in PIB)„ since the partition may be SVC 7 bound if 
all tasks were waiting. 

3. Clear page fault request. 

4. Examine the internal page fault queue (in TCB chain). 

If another page fault is found,, it is passed to the page manager routine in the 
supervisor. If no other request is found,, a page request of zero is returned to the 
page manager. 

Note: The page fault currently handled for this partition and the address of the related 
TCB are saved in the appendage routine itself. 
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ATTENTION INTERFACE APPENDAGE 



Refer to Initiation of the permanent command processor in "Command Processor" 



RJE.BSC CHANNEL END APPENDAGE 



During POWER/VS initialization a modification is made to the PIB of the POWER/VS 
partition in order to allow for a channel end appendage used for all RJE,,BSC I/O 
operations. All RJE^BSC CCBs contain the address of the same channel end appendage 
routine,, which is located in the POWER/VS nucleus in real storage- 

The appendage routine gets control from the DOS/VS I/O interrupt handler whenever an 
interrupt is received from an RJE,BSC device. It then performs the following functions: 

1. It moves bytes 1 through 3 of the CSW to the BCA (Buffer Control Area). These bytes 
contain the address of the last executed CCW plus 8, which is normally moved to the 
CCS (bytes 13-15) by the DOS/VS I/O interrupt handler. This move is not performed,, 
however, when these bytes contain the address of a channel appendage routine,, as in 
this case. 

2. It queues the BCA to a BCA chain that will be processed by the line manager. 

3. It activates the line manager. 

Control is then returned to the next sequential instruction in the DOS/VS supervisor. 

HOT READER APPENDAGE 

The supervisor passes control to this appendage whenever an unsollicited device end 
interrupt for a unit record device is recognized. 

The reader TCBs are scanned on cuu number to locate the task concerned with the 
interrupt. If the matching task is inactive,, it is posted di spate hable.. The POWER/VS 
partition is set dispatchable in PIB. In all other cases, no action is taken. 

SVC APPENDAGE 

When the SVC trap for a spooling request has located the appropriate task list entry in 
the partition control block, this appendage is entered,. 

The following actions are taken: 

• The address of the CCB is stored in the task list entry of the partition control 
block. 

• The related execution processor task ECB is posted to let the task simulate the 
request. 

• The POWER/VS master ECB is posted (in CAT) after selection later on. 

• The PIB flag for the POWER/VS partition is set dispatchable. 

• The SIO table in the Job Accounting Interface Partition table (if existing) is 
updated. 

Then control is returned to the supervisor- 
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SVC 90/91 APPENDAGE 



The supervisor passes control to this appendage whenever an SVC 90 or SVC 91 interrupt is 
recognized. The address of the account information is stored in the reader entry of the 
partition control block. The execution reader task ECB is posted. The POWER/VS 
partition is set dispatchable for task selection by the supervisor. 



Appendage Summary 






[Event 



j Appendage 



I Task Selection Action 



I Control Blocks j 
^ 



Page fault occurred 

page fault completed 
Attention interrupt 
Unsollicited device end 
RJE channel end 
SVC intercepted 



SVC 90 interrupt 
SVC 91 interrupt 



I Page Fault 
(pre- processor) 



Page Fault 

( post-processor ) 

Attention Interface! 

Hot Reader 

Channel End 

SVC 

SVC 90/SVC 91 



I Place current task in wait jTCB 

state, reenter task | 

Iselection. | 

1 I 

I Make task dispatchable^ jTCB 

[activate partition. | 

I 

Make CP task dispatchable, jTCE, CPB 
activate partition. j 

! 

Set RDR task dispatchable, jTCB 
activate partition. ] 

1 

Set LM task dispatchable, |TCB, BCA 
activate partition. | 



I Set XR/XW task dispatchable., |TCB„ PDB 
I activate partition. ] 

I 

|TCB, PDB 

I 



I S e t XR ta sk di spa tchab le „ 
j activate partition. 

-,JL - . , 



1 



v.. ..y 
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Section 3: Program Organization 



I The program organization of DOS/VS POWER/VS is described in DOS/VS POWER/VS Logic Part 2 , 
SY33-8577, which manual contains detailed descriptions of the POWER/VS phases. 



( 
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Section 4: Directory 



The purpose of this section is to establish relationships between program identifier 

names (phase names,, module names, control section names, and segment names) and between 

these names and Section 5 of this manual and the charts in DOS/VS POWER/VS Logic Part 2,. 
The directoir^ enables you to: 

^ Determine the type of name of any program identifier (phase, module, control section, 
macro, or segment), 

«"- Determine the phase with which that name is associated. 

» Determine the module with which that name is associated. 

f^ If the name is a phase, locate the appropriate chart in DOS/VS POWER/VS Logic Part 2,. 

^ If the name is a linkage macro, determine the invoked phase and its chart in 
DOS/VS POWER/VS Logic Part* 2. 

« If the name is a definition macro (control block, or data block)-, locate the matching 
figure in Section 5. 

A reference list of messages is also included in this section. It relates a message with 
the issuing phase. 
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NAME LIST 












Name 


Type 


Phase 


Module 


Reference Chart (Log 


ACCB 


Storage 


descriptor of 


control 


block. 


See Figure 5.24 


AIS 


SEGMENT 


IPW$$NU 


IPW$$NU 




BB 


AQCS 


SEGMENT 


IPW$$AQ 


IPW$$QM 






AQCS 


CSECT 


IPW$$AQ 


IPW$$QM 






ASCS 


SEGMENT 


IPW$$AS 


IPW$$DM 






ASCS 


CSECT 


IPW$$AS 


IPW$$DM 






ASWS 


Storage 


descriptor of 


control 


block. 


See Figure 5.48 


CAS A 


SEGMENT 


IPW$$SA 


IPW$$AM 






CAT 


SEGMENT 


IPW$$NU 


IPW$$NU 






CAT 


Storage 


descriptor of 


control 


block. 


See Figure 5.4 


CESG 


SEGMENT 


IPW$$NU 


IPW$$NU 




BC 


COCB 


Storage 


descriptor of 


control 


block. 


See Figure 5.34A 


CPB 


Storage 


descriptor of 


control 


block. 


See Figure 5. 13 


CPCS 


SEGMENT 


IPW$$CP 


IPW$$CM 






CPCS 


CSECT 


' IPW$$CP 


IPW$$CM 






DMB 


SEGMENT 


IPW$$NU 


IPW$$NU 






DMB 


Storage 


descriptor of 


control 


block. 


See Figure 5.8 


DMS 


SEGMENT 


IPW$$NU 


IPW$$NU 




AE 


DQCS 


SEGMENT 


IPW$$DQ 


IPW$$QM 






DQCS 


CSECT 


IPW$$DQ 


IPW$$QM 






FQCS 


CSECT 


IPW$$FQ 


IPW$$QM 






FQCS 


SEGMENT 


IPW$$FQ 


IPW$$QM 






GACS 


SEGMENT 


IPW$$GA 


IPW$$AM 






GACS 


CSECT 


IPW$$GA 


IPW$$AM 






GDCS 


SEGMENT 


IPW$$GD 


IPW$$DM 






GDCS 


CSECT 


IPW$$GD 


IPW$$DM 






GNB 


Storage 


descriptor of 


control 


bl ock . 


See Figure 5 .41 


HRS 


SEGMENT 


IPW$$NU 


IPW$$NU 




BD 


IBCS 


CSECT 


IPW$$IB 


IPW$$IB 






ICCS 


SEGMENT 


IPW$$IC 


IPW$$DM 






I CCS 


CSECT 


IPW$$IC 


IPW$$DM 






IPW$xxx see macro list below 








IPW$$AM 


MODULE 










IPW$$AQ 


PHASE 


IPW$$AQ 


IPW$$QM 




DB 


1 IPW$$AS 


PHASE 


IPW$$AS 


IPW$$DM 






IPW$$CM 


MODULE 










IPW$$CP 


PHASE 


IPW$$CP 


IPW$$CM 




CP 


IPW$$DD 


MODULE 


IPW$$DD 


IPW$$DD 






IPW$$DD 


PHASE 


IPW$$DD 


IPW$$DD 




NA 


IPW$$DM 


MODULE 










IPW$$DQ 


PHASE 


IPW$$DQ 


IPW$$QM 




DD 


IPW$$ER 


MODULE 








HC 


IPW$$FQ 


PHASE 


IPW$$FQ 


IPW$$QM 




DE 


IPW$$GA 


PHASE 


IPW$$GA 


IPW$$AM 




FB 


IPW$$GD 


PHASE 


IPW$$GD 


IPW$$DM 




EB 


IPW$$IB 


MODULE 








MG 


IPW$$IC 


PHASE 


IPW$$IC 


IPW$$DM 




GD 


IPW$$IR 


MODULE 










IPW$$I1 


PHASE 


IPW$$I1 


IPW$$IR 




LA 


IPW$$I2 


PHASE 


IPW$$I2 


IPW$$IR 




LB 


IPW$$LF 


MODULE 








ME 


IPW$$LH 


MODULE 








MK 


IPW$$LN 


MODULE 








MJ 


IPW$$LR 


PHASE 


IPW$$LR 


IPW$$RR 




HB 


IPW$$LU 


PHASE 


IPW$$LU 


IPW$$DM 




GC 


IPW$$LW 


PHASE 


IPW$$LW 


IPW$$WR 




JC 


IPW$$MD 


MODULE 










IPW$$MP 


MODULE 








MF 


IPW$$MS 


PHASE 


IPW$$MS 


IPW$$MS 




MB 


IPW$$MS 


MODULE 










IPW$$NQ 


PHASE 


IPW$$NQ 


IPW$$QM 




DC 


IPW$$NU 


MODULE 


IPW$$NU 


IPW$$NU 






IPW$$NU 


PHASE 


IPW$$NU 


IPW$$NU 




AA-BF 



V. / 
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( 



C 



Name 


Type 


Phase 


Module 


Reference Ghart (Loq: 


IPW$$OB 


MODULE 






MH 




IPW$$OC 


Module 








ML 


IPW$$OE 


MODULE 








GF 


IPW$$OT 


MODULE 


IPW$$OT 


IPW$$DM 




GG 


IPW$$PA 


PHASE 


IPW$$PA 


IPW$$AM 




FA 


IPW$$PD 


PHASE 


IPW$$PD 


IPW$$DM 




EA 


IPW$$PL 


PHASE 


iPW$$PL 


IPW$$WR 




JA 


IPW$$PP 


PHASE 


IPW$$PP 


IPW$$WR 




JB 


IPW$$PR 


PHASE 


IPW$$PR 


IPW$$RR 




HA 


IPW$$PS 


PHASE 


IPW$$PS 


IPW$$PS 




CQ 


IPW$$PS 


MODULE 










IPW$$Qiyi 


MODULE 










IPW$$RQ 


PHASE 


IPW$$RQ 


IPW$$QM 




DA 


IPW$$RR 


MODULE 










IPW$$SA 


PHASE 


IPW$$SA 


IPW$$AM 




GR 


IPW$$SC 


PHASE 


IPW$$SG 


IPW$$RR 




GA 


IPW$$SL 


PHASE 


IPW$$SL 


IPW$$DM 




GE 


IPW$$SM 


PHASE 


IPW$$SM 


IPW$$SM 




PA 


IPW$$SM 


MODULE 










IPW$$SN 


MODULE 








MG 


IPW$$TM 


PHASE 


IPW$$TM 


IPW$$TM 




MA 


IPW$$TM 


MODULE 










IPW$$TR 


PHASE 


IPW$$TR 


IPW$$TR 




LG 


IPW$$TR 


MODULE 










IPW$$VE 


MODULE 








MV 


IPW$$WR 


MODULE 










IPW$$XJ 


PHASE 


IPW$$XJ 


IPW$$XP 




GB 


IPW$$XP 


MODULE 










IPW$$XR 


PHASE 


IPW$$XR 


IPW$$XP 




KA 


IPW$$XW 


PHASE 


IPW$$XW 


IPW$$XP 




KB 


lies 


SEGMENT 


IPW$$I1 


IPW$$IR 






lies 


CSECT 


IPW$$I1 


IPW$$IR 






I2CS 


SEGMENT 


IPW$$I2 


IPW$$IR 






I2CS 


GSEGT 


IPW$$I2 


IPW$$IR 






LFCS 


GSEGT 


IPW$$LF 


IPW$$LF 






LHCS 


GSEGT 


IPW$$LH 


IPW$$LH 




MK 


LNCS 


GSEGT 


IPW$$SN 


IPW$$LN 






LMCS 


SEGMENT 


IPW$$TM 


IPW$$TM 






LRCB 


Storage 


descriptor of 


control 


block. 


See Figure S.B^^B 


LRCS 


SEGMENT 


IPW$$TM 


IPW$$TM 




RR 


LRCS 


GSEGT 


IPW$$LR 


IPW$$RR 






LUCB 


Storage 


descriptor of 


control 


block. 


See Figure 5. 34G 


LUGS 


SEGMENT 


IPW$$LU 


IPW$$DM 






LUGS 


GSEGT 


IPW$$LU 


IPW$$DM 






LWCS 


GSEGT 


IPW$$LW 


IPW$$WR 






LWCS 


SEGMENT 


IPW$$LW 


IPW$$WR 






MCB 


Storage 


descriptor of 


control 


block. 


See Figure 5.17 


MMB 


SEGMENT 


IPW$$NU 


IPW$$NU 




AD 


MMB 


Storage 


descriptor of 


control 


block. 


See Figure 5 .7 


MPCS 


GSEGT 


IPW$$MP 


IPW$$MP 






MSCB 


Storage 


descriptor of 


control 


block. 


See Figure 5.39. 


MSCS 


SEGMENT 


IPW$$MS 


IPW$$MS 






MSCS 


GSEGT 


IPW$$MS 


IPW$$MS 






NQCS 


GSEGT 


IPW$$NQ 


IPW$$QM 






NQCS 


SEGMENT 


IPW$$NQ 


IPW$$QM 






OBCS 


GSEGT 


IPW$$OB 


IPW$$OB 






OCCS 


GSEGT 


IPW$$OG 


IPW$$OG 




ML 


OTCS 


GSEGT 


IPW$$OT 


IPW$$DM 




GG 


PACCOUNT 


SEGMENT 


IPW$$GP 


IPW$$GM 






PACCOUNT 


GSEGT 


IPW$$GP 


IPW$$GM 






PACS 


SEGMENT 


IPW$$PA 


IPW$$AM 






PACS 


GSEGT 


IPW$$PA 


IPW$$AM 






PALTER 


SEGMENT 


IPW$$GP 


IPW$$GM 






PALTER 


GSEGT 


IPW$$GP 


IPW$$GM 






PBRDCST 


SEGMENT 


IPW$$GP 


IPW$$GM 
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Name 


Type 


Phase 




Module 


Reference Chart 1 


[Loc 


PBRDCST 


CSECT 


IPW$$CP 




IPW$$CM 










P CANCEL 


SEGMENT 


IPW$$CP 




IPW$$CM 










PCANCEL 


CSECT 


IPW$$CP 




IPW$$CM 










PDB 


Storage 


descriptor 


of 


control 


block. 


See 


Figure 5. 


21 


PDCS 


SEGMENT 


IPW$$PD 




IPW$$DM 










PDCS 


PHASE 


IPW$$PD 




IPW$$DM 










PDELETE 


SEGMENT 


IPW$$CP 




IPW$$CM 










P DELETE 


CSECT 


IPW$$CP 




IPW$$CM 










PDISPLAY 


SEGMENT 


IPW$$CP 




IPW$$CM 










PDISPLAY 


CSECT 


IPW$$CP 




IP"W$$CM 










PEND 


SEGMENT 


IPW$$CP 




IPW$$CM 










PEND 


CSECT 


IPW$$CP 




IPW$$CM 










PFLUSH 


SEGMENT 


IPW$$CP 




IPW$$CM 










P FLUSH 


CSECT 


IPW$$CP 




IPW$$CM 










PES 


SEGMENT 


IPW$$NU 




IPW$.$NU 


BA 








PGO 


SEGMENT 


IPW$$CP 




IPW$$CM 










PGO 


CSECT 


IPW$$CP 




IPW$$CM 










PINQUIRE 


SEGMENT 


IPW$$CP 




IPW$$CM 










PINQUIRE 


CSECT 


IPW$$CP 




IPW$$CM 










PLCS 


SEGMENT 


IPW$$PL 




IPW$$WR 










PLCS 


CSECT 


IPW$$PL 




IPW$$WR 










POWERMS 


CSECT 


IPW$$MS 




IPW$$MS 










POWERTM 


CSECT 


IPW$$TM 




IPW$$TM 










PPCS 


CSECT 


IPW$$PP 




IPW$$WR 










PPCS 


SEGMENT 


IPW$$PP 




IPW$$WR 










PPCS 


CSECT 


IPW$$NU 




IPW$$NU 










PRCS 


CSECT 


IPW$$PR 




IPW$$RR 










PRCS 


SEGMENT 


IPW$$PR 




IPW$$RR 










PRE LEASE 


SEGMENT 


IPW$$CP 




IPW$$CM 










PRELEASE 


CSECT 


IPW$$CP 




IPW$$CM 










PRE START 


SEGMENT 


IPW$$CP 




IPW$$CM 










PRESTART 


CSECT 


IPW$$CP 




IPW$$CM 










PSCS 


SEGMENT 


IPW$$PS 




IPW$$PS 










PSCS 


CSECT 


IPW$$PS 




IPW$$PS 










P SETUP 


SEGMENT 


IPW$$CP 




IPW$$CM 










PSETUP 


CSECT 


IPW$$CP 




IPW$$CM 










P START 


SEGMENT 


IPW$$CP 




IPW$$CM 










PSTART 


CSECT 


IPW$$CP 




IPW$$CM 










PSTOP 


SEGMENT 


IPW$$CP 




IPW$$CM 










PSTOP 


CSECT 


IPW$$CP 




IPW$$CM 










RMCB 


Storage 


descriptor 


of 


control 


block. 


See 


Figure 5. 


.36 


RMS 


SEGMENT 


IPW$$NU 




IPW$$NU 


AB 








RQCS 


SEGMENT 


IPW$$RQ 




IPW$$QM 










RQCS 


CSECT 


IPW$$RQ 




IPW$$QM 










SACS 


CSECT 


IPW$$SA 




IPW$$AM 










SCB 


SEGMENT 


IPW$$NU 




IPW$$NU 


AC 








SCB 


Storage 


descriptor 


of 


control 


block. 


See 


Figure 5. 


.6 


sees 


SEGMENT 


IPW$$SC 




IPW$$RR 










sees 


CSECT 


IPW$$SC 




IPW$$RR 










SLCS 


CSECT 


IPW$$SL 




IPW$$DM 










SLSD 


SEGMENT 


IPW$$SL 




IPW$$DM 










SMCS 


CSECT 


IPW$$SM 




IPW$$SM 










SNCB 


Storage 


descriptor 


of 


control 


block. 


See 


Figure 5 


.35 


SNCS 


CSECT 


IPW$$SN 




IPW$$SN 










SUCB 


Storage 


descriptor 


of 


control 


block. 


See 


Figure 5 


.37 


SVS 


SEGMENT 


IPW$$NU 




IPW$$NU 


BE, 


BF 






TACS 


SEGMENT 


IPW$$TM 




IPW$$TM 










TAGS 


CSECT 


IPW$$TM 




IPW$$TM 










TBB 


Storage 


descriptor 


of 


control 


block. 


See 


Figure 5 


.18 


TCB 


Storage 


descriptor 


of 


contro 1 


block. 


See 


Figures ! 


5.9 


TPS 


SEGMENT 


IPW$$NU 




IPW$$NU 


AF 
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Name 

TRCS 

TRCS 

TRS 

VECS 

WACB 

WCB 

WCB 

XJCS 

XJCS 

XRCS 

XRCS 

XWCS 

XWCS 



Type 

CSECT 

SEGMENT 

SEGMENT 

CSECT 

Storage 

SEGMENT 

Storage 

SEGMENT 

CSECT 

SEGMENT 

CSECT 

SEGMENT 

CSECT 



Phase 

IPW$$TR 

IPW$$TR 

IPW$$NU 

IPW$$VE 



Module 

IPW$$TR 

IPW$$TR 

IPW$$NU 

IPW$$VE 



Reference Chart (Logic Manual - Part 2) 



AG 

MV 



descriptor of control block. See Figure 5.38 

IPW$$NU IPW$$NU AA 

descriptor of control block. See Figure 5.5 

IPW$$XJ IPW$$XP 

IPW$$XJ IPW$$XP 

IPW$$XR IPW$$XP 

IPW$$XR IPW$$XP 

IPW$$XW IPW$$XP 

IPW$$XW IPW$$XP 



( 
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MACRO LIST 



Macro 


Type 


Phase 


Chart 
(Part 2) 


Fiqiire 


IPW$AQS 


LINKAGE 


IPW$$AQ 


DB 




IPW$ATT 


LINKAGE 


IPW$$NU 


AA 




IPW$CAF 


LI NKAGE 


IPW$$GA 


FB 




IPW$CLI 


LINKAGE 


Note 1 






IPW$CTT 


LINKAGE 


IPW$$NU 


AF 




1 IPW$DAB 


DEFINITION 








IPW$DAC 


DEFINITION 






5.24 


IPW$DBC 


DEFINITION 






5.33 


IPW$DCB 


DEFINITION 






5.42 


IPW$DCO 


DEFINITION 






5.34A 


IPW$DCT 


DEFINITION 






5,. 8 


IPW$DCW 


DEFINITION 






5.43 


IPW$DDE 


DEFINITION 








IPW$DDR 


DEFINITION 






5.16 


IPW$DDV 


DEFINITION 








IPW$DET 


LINKAGE 


IPW$$NU 


AA 




IPW$DGN 


DEFINITION 






5.41 


IPW$DLC 


DEFINITION 






5.32 


IPW$DLR 


DEFINITION 






5,.34B 


IPW$DLU 


DEFINITION 






5.34C 


IPW$DMC 


DEFINITION 






5.17 


IPW$DMM 


DEFINITION 






5.7 


IPW$DMS 


DEFINITION 






5.39 


IPW$DPA 


DEFINITION 






5.1 


IPW$DPC 


DEFINITION 






5.19 


IPW$DPD 


DEFINITION 






5.21 


IPW$DPW 


DEFINITION 






5.15 


IPW$DQC 


DEFINITION 






5.8 


IPW$DQR 


DEFINITION 






5.22 


IPW$DQS 


LINKAGE 


IPW$$DQ 


DD 




IPW$DRM 


DEFINITION 






5.36 


IPW$DSA 


DEFINITION 






5.13 


IPW$DSC 


DEFINITION 






5.6 


IPW$DSL 


DEFINITION 






5.23 


IPW$DSN 


DEFINITION 






5.35 


1 IPW$DSR 


DEFINITION 








IPW$DSV 


DEFINITION 






5.13 


IPW$DSU 


DEFINITION 






5.37 


IPW$DTB 


DEFINITION 






5.18 


IPW$DTC 


DEFINITION 






5.9 


[ IPW$DTE 


DEFINITION 








IPW$DWA 


DEFINITION 






5.38 


1 IPW$EQU 


DEFINITION 








IPW$FCH 


LINKAGE 


IPW$$NU 


AA 




IPW$FQS 


LI NKAGE 


IPW$$FQ 


DE 




IPW$GAR 


LINKAGE 


IPW$$GA 


FB 




IPW$GDR 


LI NKAGE 


IPW$$GD 


EB 




IPW$GLR 


LINKAGE 


Note 1 






IPW$GQS 


LINKAGE 


IPW$$NQ 


DC 




IPW$GSL 


LINKAGE 


IPW$$SL 


GE 




1 IPW$IAS 


LINKAGE 


IPW$?AS 






IPW$ICP 


LI NKAGE 


IPW$$IC 


GD 




IPW$IOC 


LINKAGE 


IPW$$OB 


MH 




IPW$OAF 


LINKAGE 


IPW$$GA 


FB 




IPW$OEF 


LINKAGE 


IPW$$OE 


GF 




IPW$OLI 


LI NKAGE 


Note 1 






IPW$OTP 


LINKAGE 


IPW$$OT 


GG 




IPW$PAR 


LI NKAGE 


IPW$$PA 


FA 




IPW$PDR 


LINKAGE 


IPW$$PD 


J5A 




IPW$PLR 


LI NKAGE 


Note 1 






IPW$RDC 


LINKAGE 


IPW$$NU 


AG 




IPW$RDD 


LI NKAGE 


IPW$$NU 


AE 





v.,.../ 



\ y 
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c 



Macro Type Phase Chart Figure 



IPW$RDQ LINKAGE 

IPW$RDT LINKAGE 

IPW$RET LINKAGE 

IPW$RLR LINKAGE 

IPW$RLW LINKAGE 





(Part 


2) 


IPW$$NU 


AE 




IPW$$NU 


AF 




Note 2 






IPW$$NU 


AB 




JPW$$NU 


AC 





( 
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A 

[ 



Macro 



IPW$RMS 
IPW$RQS 
IPW$RSR 
IPW$RSW 
IPW$SAV 
IPW$SRJ 
IPW$SXJ 
IPW$ULP 
IPW$VDA 
IPW$WFC 
IPW$WFD 
IPW$WFI 
IPW$WFL 
IPW$WFiyi 
IPW$WFO 
IPW$WFQ 
IPW$WFS 
IPW$WTD 
IPW$WTO 
IPW$WTQ 
IPW$WTR 
IPW$WTT 



Typ e 



LINKAGE 
LINKAGE 
LINKAGE 
LI NKAGE 
LINKAGE 
LI NKAGE 
LINKAGE 
LINKAGE 
LINKAGE 
LI NKAGE 
LINKAGE 
LINKAGE 
LINKAGE 
LINKAGE 
LINKAGE 
LI NKAGE 
LINKAGE 
LI NKAGE 
LINKAGE 
LI NKAGE 
LINKAGE 
LI NKAGE 



Phase 



Chart 





(Part 2) 


IPW$$NU 


AD 


IPW$$RQ 


DA 


IPW$$NU 


AB 


IPW$$NU 


AC 


Note 2 




IPW$$SC 


GA 


IPW$$XJ 


GB 


IPW$$LU 


GC 


IPW$$NU 


AH 


IPW$$NU 


AA 


IPW$$NU 


AA 


IPW$$NU 


AA 


IPW$$NU 


AA 


IPW$$NU 


AA 


IPW$$NU 


AA 


IPW$$NU 


AA 


IPW$$NU 


AA 


IPW$$NU 


AE 


IPW$$NU 


AD 


IPW$$NU 


AE 


IPW$$NU 


AD 


IPW$$NU 


AF 



Figure 



( 



Note 1: Refer to 'Interface Linkage' londer "Linkage Conventions' in 
DOS/VS POWER/VS Logic Part 2. 

Note 2: Refer to 'Function Linkage' under 'Linkage Conventions' in 
DOS/VS tOWER/VS Logic Part 2.. 



Section 4. Directory 101 



Page of SY33-8576-1 , Revised November 28, 1977, By TNL SN33-9240 



MESSAGE LIST 

Note: Whenever the field "task" appears in a message/ the same text in the code listing 
appears as "ttttt" which is replaced by the task-ID before printing. 



Message 



IQOII POWER/VS CANNOT RUN IN REAL MODE 

1Q0 2I POWER/VS CANNOT RUN AS A SUBTASK 

1Q03I INSUFFICIENT REAL STORAGE AVAILABLE; lOK REQUIRED 
INSUFFICIENT REAL STORAGE AVAILABLE; nnK REQUIRED 

iQOai QUEUE FILE MISMATCH 

1Q0 5I PAGEABLE AREA nnnK TOO SMALL 

1Q06I SYSLOG NOT ASSIGNED TO CONSOLE 

lQd7I INVALID LOGICAL UNIT 

1Q08I SUPERVISOR WITHOUT POWER/VS SUPPORT 

1Q09I TRACK GROUP CHANGED TO nn 

IQIOI SUPERVISOR WITHOUT ACCOUNTING SUPPORT 

IQIID FORMAT QUEUES= 

1Q12I POWER/VS INITIATION COMPLETED 

1Q13I ERRONEOUS AUTOSTART CARD( S) READ 

1Q14I NO MATCHING PUB FOR CUU 

1Q15I PHASE phasename NOT FOUND 

1Q16I INVALID PUN/LST ROUTING FOR remid 

1Q17I QUEUE FILE TOO SMALL 

1Q18I TOO MANY EXTENTS IJDFILE 

1Q19I INVALID EXTENT IJDFILE 

1Q2 0I AUTOSTART IN PROGRESS 

1Q21I POWER/VS HAS BEEN TERMINATED 

1Q22I POWER/VS ALREADY ACTIVE 

1Q23I LTA CANCEL 

1Q24I QUEUE FILE CHAIN ERROR 

1Q25I partition IN STOP STATE 

1Q2 6I GETVIS AREA TOO SMALL 

1Q27I UNABLE TO INITIALIZE SPOOL MANAGEMENT 

1Q3 0D ABNORMAL POWER/VS TERMINATION, PRINTER= 

1Q31I MORE THAN 80% FULL ACCOUNT FILE (IJAFILE) ****** 

1Q32I NO MORE ACCOUNT FILE (IJAFILE) SPACE FOR task,, CUU 

1Q33I STOPPED task,cuu 

1Q3UI task WAITING FOR WORK ON CUU 



1Q35A EOF ON CUU 

1Q36I task CANCELED DUE TO I/O ERROR ON cuu 

1Q37I JECL CARD INCORRECT NEAR COLUMN xxx 



1Q3 8I NO DASD SPACE AVAILABLE FOR ttt,,CUU 

I 1Q39I JOB jjjjjjjj FLUSHED BY THE OPERATOR OR POWER/VS 

IQUOA ON task FORMS ffff NEEDED FOR jjjjjjjj nnnnnn 

1Q41I WRONG PRINTER/PUNCH FOR jjjjjjjj CUU 

1Q42I PAGE/CARD COUNT EXCEEDS END QUEUE ENTRY FOR CUU 

1Q43I END OF SPOOL TAPE task, CUU 

IQUai BOOK s.bbbbbbbb NOT FOUND 

1Q4 5I SLI STATEMENT NOT SUPPORTED 

1Q46I DISP FORCED TO D FOR jjjjjjjj nnnnnn 

1QU7I task jjjjjjjj nnnnnn FROM rrr uuuuuuuuuuuuuuuu 

1Q4 8D NO MATCHING SPOOL DEVICE task 

1Q49D INVALID DELIMITER task 

1Q50D UNKNOWN KEYWORD task 



Phase 



Chart 





(Part 2) 


IPW$$I1 


LA02 


IPW$$I1 


LAOl 


IPW$$I1 


LA04 


IPW$$I2 


LB20 


IPW$$I2 


LB05 


IPW$$I1 


LAOS 


IPW$$I1 


LAOl 


IPW$$I2 


LB22 


IPW$$I1 


LA02 


IPW$$I2 


LB07 


IPW$$I1 


LA02 


IPW$$I2 


LB04 


IPW$$I2 


LBia 


IPW$$I2 


LB04 


IPW$$I1 


LA02,,LA04 


IPW$$I1 


LAO 5 


IPW$$I1 


LA03,,LA04 


IPW$$I2 


LB07 


IPW$$I2 


LB18 


IPW$$I2 


LB07,LB18 


IPW$$I2 


LB13 


IPW$$I2 


LB14 


IPW$$I1 


LAOl 


IPW$$I2 


LB04 


IPW$$I2 


LB06 


IPW$$IR 


LB15 


IPW$$I1 


LA03 


IPW$$I2 


LB13 


$$BPOWIN 


LDOl 


IPW$$PA 


FA02 


IPW$$PA 


FA03 


IPW$$TR 


LC14 


IPW$$XR 


KA04 


IPW$$LW 


JCOl 


IPW$$PR 


HA05 


IPW$$XR 


KA07 


IPW$$PR 


HA 05 


IPW$$PR 




IPW$$LR 


HB16.,HB17,, 




HB18-HB19 


IPW$$RQ 


DA 01 


IPW$$PD 


EA02 


IPW$$RQ 


DA 01 


IPW$$LW 


JC07„JC08 


IPW$$LW 


JC03 


IPW$$LW 


JC0 2 


IPW$$LW 


JCIO 


IPW$$NQ 


DCOl 


IPW$$SL 


GE08 


IPW$$XJ 


GB15 


IPW$$XJ 


GB07 


IPW$$XJ 


GB05 


IPW$$XJ 


GB06 


IPW$$XJ 


GB0'4,GB08, 




GBIU 


IPW$$XJ 


GBIO 



^,. 



y 
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Message 



Phase 



Chart 



1Q51D 



( 



1Q52I 
1Q53I 
1Q54I 
1Q55D 
1Q56I 
1Q57A 
1Q5 8A 
1Q59I 
1Q60I 
1Q61I 



1Q61D 

1Q62I 
1Q63I 
lQ6ai 

1Q65I 
1Q66I 
1Q67I 
1Q68I 
1Q69I 
1Q70I 
1Q71I 
1Q7 2I 
1Q73I 
lQ7ai 
1Q75I 
1Q76I 
1Q77I 
1Q7 8I 
1Q79I 

1Q8 0I 
1Q81I 
1Q82I 
1Q8 3I 
1Q87I 



INVALID DISP PARAMETER task 

INVALID CLASS PARAMETER task 

INVALID FNO PARAMETER task 

INVALID COPY PARAMETER task 

INVALID TADDR PARAMETER task 

INVALID LTAB PARAMETER task 

INVALID REMOTE PARAMETER task 

INVALID JSEP PARAMETER task 

INVALID REM PARAMETER task 

INVALID RBS PARAMETER task 

INVALID PRI PARAMETER task 

INVALID UCS PARAMETER task 

INVALID FCB PARAMETER task 

INVALID LST PARAMETER task 

INVALID PUN PARAMETER task 

INVALID JNM PARAMETER task 

INVALID USER PARAMETER task 

INVALID COPYG PARAMETER task 

INVALID FLASH PARAMETER task 

INVALID BURST PARAMETER task 

INVALID DFLT PARAMETER task 

INVALID CHARS PARAMETER task 

INVALID MODIFY PARAMETER task 

OUTPUT LIMIT EXCEEDED FOR jjjjjjjj nnnnnn task 

OUTPUT SEGMENTED FOR jjjjjjjj nnnnnn task 

FCB/UCS ERROR FOR jjjjjjjj nnnnnn task 

SPECIFY TAPE ADDRESS FOR jjjjjjjj nnnnnn task 

INVALID TAPE ADDRESS/MODE SET 

WRITE RING REQUIRED ON CUU task 

MOUNT TAPE ON CUU FOR jjjjjjjj nnnnnn task 

task, CUU WAITING FOR REAL STORAGE 

OPEN FAILURE ON P ACCOUNT OUTPUT DEVICE 

IRRECOVERABLE I/O ERROR ON xFILE n CUU 

IRRECOVERABLE I/O ERROR ON SYSTEM/PVT SSL 
IRRECOVERABLE I/O ERROR ON CUU 

IRRECOVERABLE I/O ERROR ON PACCOUNT OUTPUT DEVICE 

IRRECOVERABLE I/O ERROR ON task^CUU - CANCEL,, 

RESTART, OR IGNORE? 

CANCEL FOR POWER/VS IGNORED 

IRRECOVERABLE I/O ERROR IN QUEUE MASTER REC -• CUU 

JOB jjjjjjjj task SET DELETED 

UNKNOWN task SET DELETED 

ACCOUNT FILE KEPT 

FREE SET NOT ACCESSIBLE 

SEGMENTATION FORCED FOR jjjjjjjj nnnnnn task CUU 

DEFAULT OPTIONS TAKEN FOR jjjjjjjj nnnnnn task cuu 

TASK FAILURE, STOPPED task 

task,, CUU TERMINATED 

PACCOUNT TERMINATED 

STATUS DISPLAY TERMINATED 

ACCOUNT SUPPORT FUNCTIONS TERMINATED 

MULTIPLE TERMINATION OF TASK,, POWER/VS TERMINATED 

POWER/VS CANNOT CONTINUE 

INVALID SPOOL TAPE task, CUU 

NO REAL STORAGE AVAILABLE FOR task, CUU 

ACCOUNT FILE SAVED 

ACCOUNT FILE ERASED 

•filename' EXTENT TOO SMALL, COMMAND NOT EXECUTED 

I/O ERROR DURING task, POWER/VS TERMINATED 

ACCOUNT FILE NOTHING TO SAVE 

CUU EOJ ADDED jobna me , job number 





(Part 2) 


IPW$$XJ 


GBIU 


IPW$$XJ 


GB08„GB10 


IPW$$XJ 


GB08,GB10 


IPW$$XJ 


GB09„GB11 


IPW$$XJ 


GB09„GB11 


IPW$$XJ 


GB13 


IPW$$XJ 


GBIO 


IPW$$XJ 


GBIO 


IPW$$XJ 


GB09,GB11 


IPW$$XJ 


GBll 


IPW$$XJ 


GB12 


IPW$$XJ 


GB12 


IPW$$XJ 


GB12 


IPW$$XJ 


GB12 


IPW$$XJ 


GB12 


IPW$$XJ 


GB04 


IPW$$XJ 


GB04 



IPW$$XW 


KB14 


IPW$$XW 


KB0 6 


IPW$$XW 


KB02 


IPW$$OT 


GGOl 


IPW$$OT 


GGOl 


IPW$$OT 


GG0 2 


IPW$$OT 


GG02 


IPW$$NU 


ACOl 


IPW$$SA 


CR09 


IPW$$TR 


LC03,LC04„ 




LC08 


IPW$$TR 


Lcoa 


IPW$$TR 


LC11,LC13, 




LCia,LC16 


IPW$$TR 


LC15 


IPW$$WR 


JA02.1 


DOS/VS 


Transient 


IPW$$TR 


LC04 


IPW$$TR 


LC05„LC07„ 




LC08 


IPW$$TR 


LC06 


IPW$$TR 


LC12 


IPW$$TR 


LC05 


IPW$$TR 


LCll 


IPW$$TR 


LCll 


IPW$$TR 


LC13 


IPW$$TR 


LC14 


IPW$$TR 


LC12 


IPW$$TR 


LC13 


IPW$$TR 


LC04 


IPW$$TR 


LCOl 


IPW$$TR 


LC04 


IPW$$NQ 


DCOl 


IPW$$SA 


CR01,,CR12 


IPW$$SA 


CR0U,CR08, 




CRll 


IPW$$SA 


CR05 


IPW$$SA 


CRll 


IPW$$TR 


LCOl 


IPW$$SA 


CROl 


IPW$$ER 


HC08 
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Message 



Phase 



Chart 



1Q88I 
1Q89I 
1Q90I 
1Q91D 



1Q92D 
1Q93D 
1Q9 4D 
1Q95D 
1Q96I 
1Q97D 
1Q98D 
lQ9nD 
lQ9nD 
1QA0I 
1QA1I 
1QA2I 
1QA3I 
1QA4I 
1QA5A 
1QA6I 
1R02I 
1R0 3I 
IRIOI 
IRllI 
1R12I 
1R13I 
1R14I 
1R15I 
1R16I 
1R17I 
1R18I 
1R19I 
1R20I 
1R21I 
1R22I 
lR2ai 
1R30I 

1R33D 



1R3UI 
1R35D 

1R41I 
1R42I 
1RU3I 
1R44I 
1R4 5I 



INVALID 3540 UNIT FOR task 

PROGRAM OUT OF SEQUENCE FOR task 

* $$ RDR STATEMENT NOT ALLOWED — JOB FLUSHED 

cuu NON- COMPATIBLE DISKETTE FOR rdr^cuu 
VOLl LABEL ERROR OR NOT FOUND R= 
NON-BASIC EXCHANGE DISKETTE TYPE R- 
NON-BASIC EXCHANGE ffffffff FILE R= 
fff fff f f BYPASS REQUIRED R= 
LABEL STANDARD VERSION VIOLATION R= 
MULTIVOLUME IND NOT C, L, OR BLANK R= 
ff fff fff END XTNT BELOW BEGIN XTNT R= 
VOL SEQ NO. ERR HDRl LABEL (nnnnn) R= 
BLOCKLENGTH ERR HDRl LABEL (nnnnn) R= 
BEGINEXTENT ERR HDRl LABEL (nnnnn) R= 
END EXTENT ERR HDRl LABEL (nnnnn) R= 
END-OF- DATA ERR HDRl LABEL (nnnnn) R= 
EOD ADDR BELOW BEGIN XTNT R= 

CUU NO HDRl FOR ffffffff,, rdr, cuu R= 

cuu SECURED VOLUME/FILE FOR rdr,CUU R= 

cuu EXPECT VOL nn, NOT mm,, rdr^cuu R= 

cuu NON-VERIFIED ffffffff,, rdr,cuu R= 

cuu ffffffff IS EMPTY FILE FOR rdr,cuu 

cuu PREMATURE LAST VOL FOR rdr^cuu R= 

cuu ffffffff TOO MANY VOLS rdr,cuu R= 

NO PRECEEDING VOL,, INCONSIST RESP R= 

INVALID RESPONSE R= 

NO SUBTASK AVAILABLE FOR task, cuu 

SETPRT ROUTINE NOT FOUND IN SVA task, cuu 

CATASTROPHIC LOGIC ERROR OCCURRED re 

SETPRT ERROR FOR jjjjjjjj nnnnn task, cuu 

OUTPUT PROCESSING STOPPED jjjjjjjj nnnnn task, cuu 

cuu SETUP REQUIRED jjjjjjjj -FORMS= ~FLASH= -THREAD= 

NO STORAGE AVAILABLE FOR task, cuu 

LINE CUU STOPPED 

TRANSM number, TIMEOUTS number, ERRORS number 

INVALID commando ode COMMAND 

INVALID STOP/SETUP COMMAND 

INVALID CLASS SPECIFICATION 

INVALID TASK SPECIFICATION 

EOF ON THE READER 

REMOTE remid SIGNED ON 

REMOTE remid SIGNED OFF 

LINE HAS BEEN STOPPED 

REMOTE remid FORCED TO SIGN OFF 

FIRST CARD MUST BE SIGNON COMMAND 

nnn MESSAGES DELETED 

SIGNON IGNORED. INVALID REMOTE- ID 

SIGNON IGNORED. INVALID PASSWORD 

xxxx COMMAND OUT OF SEQUENCE 

INVALID CCW-CCB ADDR = X'ccb addr ' jobname 

j obn umber ,, cuu 

CORRECT FULL STATEMENT 

NO VALID CORRECTION 

ERROR IN CONTINUATION CARD-CORRECT FULL STATEMENT 

CCCC....CCC (52 characters) 

VOLl LABEL ON task, cuu - ENTER DISK,, TAPE., OR 

IGNORE 

INVALID SPECIFICATION FOR DISKETTE 

OPERAND 7 INCORRECT 

OPERAND 6 INCORRECT 

OPERAND 5 INCORRECT 

OPERAND 4 TOO LONG 





(Part 2) 


IPW$$XR 


KA08 


IPW$$XR 


KAIO 


IPW$$LR 


HB19 


IPW$$OE 


GF03 


IPW$$OE 


GF0 3 


IPW$$OE 


GF04 


IPW$$OE 


GF0 4 


IPW$$OE 


GF03 


IPW$$OE 


GEO 4 


IPW$$OE 


GF06 


IPW$$OE 


GEO 5 


IPW$$OE 


GF05 


IPW$$OE 


GEO 5 


IPW$$OE 


GEO 6 


IPW$$OE 


GEO 6 


IPW$$OE 


GF06 


IPW$$OE 


GEO 9 


IPW$$OE 


GF09 


IPW$$OE 


GEO 9 


IPW$$OE 


GFIO 


IPW$$OE 


GFIO 


IPW$$OE 


GFIO 


IPW$$OE 


GFll 


IPW$$OE 


GF13 


IPW$$OE 


GF11,GF13 



J 



IPW$$TM 


MA48 


IPW$$TM 


MA25 


IPW$$TM 


MA33 


IPW$$TM 


MA31 


IPW$$TM 


MA30 


IPW$$TM 


MA32 


IPW$$TM 


MAO 2 


IPW$$TM 


MA29 


IPW$$TM 


MA25 


IPW$$TM 


MA25 


IPW$$TM 


MA25 


IPW$$TM 


MA02 


IPW$$MS 


MB04 


IPW$$TM 


MA27 


IPW$$TM 


MA28 


IPW$$TM 


MA32 


IPW$$XP 


KA07.1 


IPW$$XJ 


GB07 


IPW$$XP 


GB07 


IPW$$XP 


GB07 


IPW$$OT 


GG03 


IPW$$OT 


GG03 


IPW$$CP 


CP21 


IPW$$CP 


CP20 


IPW$$CP 


CP20 


IPW$$CP 


CP20 


IPW$$CP 


CP20 
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Message 



Phase 



Chart 



1M6I 



lRa7I 
1R48I 
1R49I 



1R50D 



status report 

class QUEUE NOTHING TO DISPLAY 

TIME IS xx:xx:xx^ DATE IS xx/xx/xx 

NOTHING TO DISPLAY 

NO MESSAGES PENDING 

NO READER OR WRITER TASK CURRENTLY ACTIVE 

FREE RECORDS QUEUE FILE nnnnn 

ACCOUNT FILE nn% FULL 

NO ACCOUNTING SUPPORT 

task READER= 

task PRINTERS= 

task PUNCHES= 





(Part 2) 


IPW$$PS 


CP0 2 


IPW$$CP 


CP39 


IPW$$CP 


CP9 5 


IPW$$CP 


CP39 


IPW$$CP 


CP38 


IPW$$CP 


CP37 


IPW$$CP 


CP36 


IPW$$CP 


CP36 


IPW$$CP 


CP36 


IPW$$CP 


CP91 


IPW$$CP 


CP91 


IPW$$CP 


CP91 



( 
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Message 

1R51I OPERAND 1 DESIGNATES NON-EXISTING TASK 



NON-EXISTING TASK DESIGNATED 
IRS 2 I NO STATUS REPORT IN PROGRESS 

NO SECOND OPERAND ALLOWED FOR PSTOP PARTITION 

OPERAND 2 NEITHER DECIMAL NOR OMITTED 

OPERAND 2 NEITHER 'HOLD' NOR OMITTED 

NO VALID KEYWORD SPECIFIED 

OPERAND n IS NOT SPECIFIED AS KEYWORD 

OPERAND 1 INVALID DESTINATION 

OPERAND n IS INVALID KEYWORD 

OPERAND 1 MISSING OR INVALID 

OPERAND 1 OR 2 INVALID 
OPERAND 2 NO DEVICE ADDRESS 
OPERAND 1 NO VALID QUEUE 

OPERAND 1 NOT 'STATUS' 
INVALID NUMBER OF COPIES 
SECOND OPERAND INVALID 
OPERAND 3 NOT DECIMAL 
INVALID DISPOSITION 
INVALID REMOTE ID 
LAST OPERAND INVALID 
OPERAND 1 INVALID 
OPERAND 2 INVALID 



INVALID PRIORITY 

INVALID CLASS 

INVALID OUTPUT-CLASS 

BUFFER SPECS NOT 1 OR 2 

INVALID OPERAND 

DELIMITER NOT BLANK OR COMMA 

INVALID COMPACT NAME 

OPERAND 3 INVALID 

INVALID BUFFER SPECIFICATION 

OPERAND 4 IGNORED 
1R53I INVALID DENSITY 
1R54I CLASS X INVALID 
1R55I INVALID FILENAME 
1R56I cuu PROCESSING remid 

CUU NOT INITIATED 

CUU INACTIVE 

NO LOGICAL UNIT LOGGED ON 

luname PROCESSING reitiid 

luname NOT LOGGED ON 

limame LOGGED ON 

luname LOGGING ON 
1R57I COMMAND IGNORED,, TASK IS AT JOB BOUNDARY 

RDREXIT FLUSH IGNORED,, TASK IS AT JOB BOUNDARY 
1R58I DEVICE CUU NOT KNOWN 

DEVICE CUU IN USE 

DEVICE CUU IS DOWN 
1R59I OPERAND 2 IGNORED 
1R60I partition NOT SUPPORTED 
1R61I INVALID FOR WRITER-ONLY PARTITION 
1R6 2I INVALID RJE PASSWORD 
1R63I partition PRIORITY TOO HIGH 
1R6 4I SYSLST LUB NOT AVAILABLE 

SYSLST LUB NOT AVAILABLE task, cuu 

NO FREE LUB AVAILABLE 

NO LUB AVAILABLE, 

DISP FORCED TO D jobname, jobn umber, partition 



Phase 



Chart 





(Part 2) 


IPW$$CP 


CP55,CP62, 




CP63,, CP66„ 




CP67 


IPW$$CP 


CP67 


IPW$$CP 


CP58 


IPW$$CP 


CP57 


IPW$$CP 


CP61 


IPW$$CP 


CP66 


IPW$$CP 


CP26 


IPW$$CP 


CP26 


IPW$$CP 


CP64 


IPW$$CP 


CP26 


IPW$$CP 


CP55,CP66„ 




CP67 


IPW$$CP 


CP64 


IPW$$CP 


CP67 


IPW$$CP 


CP25,CP52, 




CP59 


IPW$$CP 


CP58 


IPW$$CP 


CP30 


IPW$$CP 


CP57 


IPW$$CP 


CP52,CP59 


IPW$$CP 


CP28 


IPW$$CP 


CP31 


IPW$$CP 


CP72 


IPW$$CP 


CP35,CP4t| 


IPW$$CP 


CP25,,CP52,, 




CP53„CP56, 




CP59 


IPW$$CP 


CP27 


IPW$$CP 


CP29 


IPW$$CP 


CPU 


IPW$$CP 


CP22 


IPW$$CP 


CP68 


IPW$$CP 


CP70 


IPW$$CP 


CP25 


IPW$$CP 


CP61.1 


IPW$$CP 


CP22.1 


IPW$$CP 


CP22.1 


IPW$$CP 


cpue 


IPW$$CP 


CP88 


IPW$$CP 


CP4U,CP46 


IPW$$CP 


CP69 


IPW$$CP 


CP69 


IPW$$CP 


CP69 


IPW$$CP 


CP68 


IPW$$CP 


CP68 


IPW$$CP 


CP68 


IPW$$CP 


CP68 


IPW$$CP 


CP68 


IPW$$CP 


CP61,CP66 


IPW$$LR 


HB14 


IPW$$CP 


CP45,CP78 


IPW$$CP 


CP78 


IPW$$CP 


CP78 


IPW$$CP 


CP50 


IPW$$CP 


CP07 


IPW$$CP 


CP66 


IPW$$CP 


CP23 


IPW$$CP 


CP07„CP08 


IPW$$CP 


CP77 


IPW$$PL 




IPW$$CP 


CP77 
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Message 



1R65I RJE-BSC NOT SUPPORTED 



RJE.SNA ALREADY STARTED 

RJE/SNA NOT STARTED 

RJE.SNA NOT SUPPORTED 

RJE,,SNA NOT ACTIVE 

cuu LIST WRITER TASK DOES NOT EXIST 

NO WRITER TASK SPECIFIED 



Phase 



Chart 



1R66I 



1R67I 

1R6 8I 

1R6 9I 
1R7 0I 
1R71I 
1R72I 
1R7 3I 
1R74I 



1R7 5I 
1R76I 
1R77I 
1R78I 
1R79I 
1R8 0I 
1R81I 

1R8 2I 
1R83I 
1R8 4I 
1R85I 
1R8 6I 
1R87I 
1R88I 



1R89I 
1R90I 
1R91I 
1R92I 
1R93I 

1R9 4I 
1R95I 
1R97I 
1R98I 
1R99I 

IVOII 
1V02I 
1V03I 



1V04I 
1V0 5I 



OPERAND 2 REDUCED TO 9999 

NUMBER OF PAGES REDUCED TO 99 

partition PARTITION NOT AVAILABLE 

XX IS THE POWER PARTITION 

NO ACCOUNTING SUPPORT 

NO DEVICE ADDRESS SPECIFIED 

OPERAND n IS NO VALID READER/PRINTER/PUNCH 

VIRTUAL partition SMALLER THAN 6UK 

INVALID DEVICE TYPE FOR xxx 

OPERAND n INVALID PRINTER SPECIFICATION 

INVALID TAPE SPECIFICATION 

INVALID DEVICE SPECIFICATION 

NO PRINTER ADDRESS SPECIFIED 

INVALID LINE ADDRESS 

partition AUTO STARTED 

NUMBER OF PAGES NOT DECIMAL 

TASK NOT WAITING FOR OPERATOR 

SHORT 'PEND' NO LONGER SUPPORTED 

ERRONEOUS AUTOSTART CARD( S) READ 

WARNING: CLASS SPECIFICATION IGNORED 

MESSAGE DOES NOT START WITH QUOTE 

MESSAGE TOO LONG OR NO CLOSING QUOTE 

•PSETUP' OR 'PRESTART' IN PROGRESS 

OPERAND NEITHER "ALL" NOR LINE ADDRESS 

DELETION NOT ALLOWED OR IMPOSSIBLE 

COMMAND INVALID FOR REMOTE OPERATOR 

PLEASE SPECIFY DEVICES TO BE SPOOLED 

TOO MANY CLASSES,, FIRST n PROCESSED 

NOTHING TO RELEASE 

NOTHING TO DELETE 

NOTHING TO ALTER 



OK 



JOB DDDDDDDD nnnnnn CANNOT BE ALTERED 
JOB jobname jobnumber CANNOT BE ALTERED (PDIR) 
POWER/VS INITIATION NOT COMPLETE 
INVALID TASK SPECIFICATION, operand 
TOO MANY OPERANDS., FIRST n PROCESSED 
ALLUSER MESSAGE QUEUE IS FULL 
REMOTE remid CURRENTLY NOT SIGNED ON 
NO SESSION ESTABLISHED FOR xxxxxxxx 
INVALID DEVICE DUPLICATION 
LINE CUU NOT SUPPORTED 

COMMAND INVALID DURING SHUTDOWN PERIOD 
INVALID POWER/VS COMMAND CODE 
POWER/VS IS IN SHUTDOWN PERIOD 
POWER/VS HAS BEEN TERMINATED 
NO SUBTASK AVAILABLE FOR RJE^SNA 
VTAM OPEN FAILURE RTNCD=return code 
ERROR ON rpl request type RTNCD,FDB2=r tncd,fdb2 
SENSE= sense 

RJE,,SNA STARTED 
RJE,SNA TERMINATED 





(Part 2) 


/' 


IPW$$CP 


CP90,,CP6a 
CP68 


K:,^._ 


IPW$$CP 


cp2a 




IPW$$CP 


CP56 




IPW$$CP 


CP2a,,CP56 




IPW$$CP 


CP56 




IPW$$CP 


CP65 




IPW$$CP 


CP62„CP63, 
CP66 




IPW^$$CP 


CP61 




IPW$$CP 


CP65 




IPW$$CP 


CP12 




IPW$$CP 


CP7 




IPW$$CP 


CP44 




IPW$$CP 


CP62 




IPW$$CP 


CP92 




IPW$$CP 


CP09 




IPW$$CP 


CP79 




IPW$$CP 


CPt|8,,CP50 




IPW$$CP 


CPUS 




IPW$$CP 


CP17,,CP21 




IPW$$CP 


CP65 




IPW$$CP 


CP23 




IPW$$CP 


CP91 




IPW$$CP 


CP65 




IPW$$CP 


CP65„CP67 




IPW$$CP 


cpa8 




IPW$$CP 


CP92,CP9a 




IPW$$CP 


CP16 




IPW$$CP 


CP71 




IPW$$CP 


CP71 




IPW$$CP 


CP61 




IPW$$CP 


CP68 




IPW$$CP 


CP53 




IPW$$CP 


CP44„CPa8 




IPW$$CP 


CP91 




IPW$$CP 


CP88 




IPW$$CP 


CP59 




IPW$$CP 


CP52 




IPW$$CP 


CP25 




IPW$$CP 


CP25„CP52., 




IPW$$CP 


CP25,,CP52, 
CP59 




IPW$$CP 


CP32 




IPW$$CP 


CP32 




IPW$$CP 


CPU8 




IPW$$CP 


CP04 




IPW$$CP 


CP2f+,CP70 




IPW$$CP 


cpeu 




IPW$$CP 


cp6a 




IPW$$CP 


CP56 




IPW$$CP 


cp9a 




IPW$$CP 


CP68 




IPW$$CP 


CP02 




IPW$$CP 


CP74 




IPW$$CP 


CP51 




IPW$$CP 


CP48 




IPW$$SN 


MC3 




IPW$$SN 


MC3 




IPW$$SN 


MC3,,MCa,, 
MC9 




IPW$$SN 


MC4 


,4' 


IPW$$SN 


MC8 


\ 



./ 
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Message 

1V0 6I UNABLE TO LOGON luname RC=yYy 



1V07I ERROR ON rpl request type RTNCD„FDB2=rtncd,fdb2 
SENSE= sense ON luname 



Phase 



Chart 



I IV 081 luname BIND PARAMETERS INVALID 

1V09I REMOTE remid LOGGED ON TO POWER ON luname 

IVIOI RJE,,SNA IS IN SHUTDOWN PERIOD 

IVllI REMOTE remid LOGGED OFF FROM POWER ON luname 

1V12I LOGOFF COMPLETED 

1V13I LOGOFF FORCED 

1V14I SESSION IS IN SHUTDOWN PERIOD 

1V15I NO STORAGE AVAILABLE FOR task 

1V16I NO STORAGE AVAILABLE FOR task FOR luname rrr 

1V17A task SUSPENDED FOR FORMS MOUNT 

1V18A REPLY WITH RESTART ON INTERVENTION REQUIRED task 

1V22I INVALID command code COMMAND 

1V23I command code OUT OF SEQUENCE 

I 1V24I task TERMINATED REASON=reason code 

1V25I EOJ ADDED FOR jobname jobnumber 

1V26I INVALID REMID, PASSWORD, OR LUNAME RC=yyy 

1V27I REMID remid EXCEEDS SESSLIM 

1V28I JOB jobname GETVIS FOR COCB FAILED 

1V29I JOB jobname GETVIS FOR COMPACT TABLE FAILED 

1V3 0I JOB jobname COMPACTION TABLE NOT FOUND 

1V31I JOB jobname NO SPACE AVAIL. IN COMPACT POOL 

1V32I JOB jobname INVALID COMPACTION TABLE 

1V33I REMOTE remid OUTPUT FOR NON WRITER WORK STATION 

1V34I (bind parameters are printed on the console) 





(Part 2) 


IPW$$LN 


MK4,MK5 




MK11 


IPW$$LH 


MK6,MK10 


IPW$$SN 


MC3,MC4 




MC9 


IPW$$LN 


MK4,MK1 1 


IPW$$MP 


MF5 


IPW$$IB 


MGi|,,MG5„ 




MGIO 


IPW$$OB 


MH8„MH12„ 




MH13„MH16„ 


IPW$$LH 


MK6,MK16 


IPW$$LH 


MK8 


IPW$$LN 


MK1 1 


IPW$$SN 


MC6,,MC12 


IPW$$LF 


ME2 


IPW$$LF 


ME2 


IPW$$LF 


ME 2 


IPW$$SN 


MC12 


IPW$$OB 


MH3 


IPW$$OB 


MH3 


IPW$$OB 


MH6 


IPW$$OB 


MH16 


IPW$$IB 


MGll 


IPW$$TB 


MGll 


IPW$$IB 


MG5,,MG10 


IPW$$OB 


MH8 


IPW$$IB 


MG4 


IPW$$LH 


MK7,MK2 


IPW$$LH 


MK21 


IPW$$OC 


ML3 


IPW$$OC 


ML 4 


IPW$$OC 


ML6 


IPW$$OC 


ML2 


IPW$$OC 


ML 6 


IPW$$SN 


MC33 


IPW$$LH 


MK8 
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Section 5. Layout of the Storage and Data Areas 



This section describes the control blocks^ buffer areas., save areas and work spaces 
required by POWER/VS in addition to the storage layout of the POWER/VS partition. 

The first three figures act as a visual table of contents and contain references to the 
figure numbers where every area is shown in detail. Relationships between fundamental 
I areas are shown in Figure 5.48 in the form of a series of examples. 

Storage Descriptors 

Most POWER/VS control blocks and many sections of POWER/VS code are equipped with storage 
descriptors which serve to rapidly locate and identify important values within a storage 
dump. A storage descriptor is a 16-byte alphameric character string with line alignment. 
Where appropriate,, storage descriptors may also be addressed by internal programming. 
For instance, the storage descriptors of some TCBs are modified dynamically to reflect 
the function that the TCB is performing at any given time. For example, a storage 
descriptor of 

TCBblRDR.030.000 

indicates the start of a task control block for an RJE reader task on RJE line number 30 
invoked by the central operator. Thus, a storage descriptor identified in a dump 
constitutes a debugging aid. 



( 
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The Position o£ the POWER/VS Data Areas 



THE POWER/VS PARTITION STORAGE LAYOUT 



DOS/VS Terminology 



Start of 
Partition 



Virtual 

Partition 

(ALLOC) 



Real 

Storage 

(ALLOCR) 



Virtual 
Storage 



Pernnanent Storage Area 
plus 

IPW$$NU - Nucleus Routines 



Remainder of 
Real Storage 



Dynamic Storage for IPW$$CP 



IPW$$I2 - Initiator / Terminator 



IPW$$CP - Command Processor 



IPW$$PR - Physical Reader 



IPW$$PD- Put Data (1) 

(loaded twice) 



IPW$$LR - Logical Reader 



IPW$$SC-JECL Scanner 



IPW$$PL - Physical List 



IPW$$GD-GetData(1) 

(loaded twice) 



IPW$$LW - Logical Writer 



IPW$$PP - Physical Punch 



POWER/VS Terminology 



T 



Permanent = 8K 



RSIZE 



Fixable =(ALL0CR-8K) 
(max 120K) 



Pageable 

Storage 

(min142K) 



VSIZE 



(cont.) 



Figure 5.0. POWER/VS Partition Storage Layout (Part 1 of U) 
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POWER/VS Partition Layout 
(cont.) 



( 



Virtual 


Virtual 


Partition 


Storage 


(cont.) 


(cont.) 



IPW$$XR - Execution Reader 



IPW$$GD - Get Data (2) 

(loaded twice) 



IPW$$XW - Execution Writer 



IPW$$PD - Put Data (2) 

(loaded twice) 



IPW$$XJ - Execution JECL Scanner 



IPW$$RQ - Request Queue 



IPW$$AQ - Add to Queue 



IPW$$NQ - Get Next Queue 



IPW$$DQ - Delete Queue 



IPW$$FQ - Free Queue 



IPW$$LU - Logical Unit Assigns 



IPW$$AS - Asynchronous Service 



IPW$$PS - Print Status 



IPW$$IC - Invoke Command 
Processor 



IPW$$OT - Open Tape 



Pageable 
Storage 
(cont.) 



VSIZE 
(cont.) 



(cont.) 



Figure 5.0. POWER/VS Partition Storage Layout (Part 2 of U) 
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POWER/VS Partition Layout 
(com.) 



IPW$$TR - Abnormal Termination 



IPW$$ER - 3540 Physical Reader 



IPW$$OE - Open 3540 Device 



IPW$$MS - Message Handler 



Optional Support 



Virtual 

Partition 

(cont.) 



Virtual 
Storage 
(cont.) 



IPW$$TM 


- BSC, RJE Terminal Manager 


IPW$$PA ■ 


Accounting: 

Put Account Rec. 


IPW$$GA 


- Accounting: 

Get Account Rec. 


IPW$$SA- 


Accounting: 

Save Account Rec. 


IPW$$SL - 


SLI SUPPORT 


iPW$$SN ■ 


RJE,SNA: SNA Manager 


IPW$$LF ■ 


RJE, SNA: Logoff Processor 


IPW$$MP 


- RJE, SNA: Message Processor 


IPW$$MD 


- RJE, SNA: Message Definition 



Storage 
(cont.) 



VSIZE 
(cont.) 



X„ .y 



(cont ^ 



Figure 5.0. POWER/VS Partition Storage Layout (Part 3 of 4) 



4^ "^ 
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POWER/VS Partition Layout 
Optional Support (cont.) 



Virtual 

Partition 

(cont.) 



End of 
Partition 



Virtual 
Storage 
(cont.) 



IPW$$IB - RJE, SNA: Inbound Processor 



IPW$$OB - RJE, SNA: Outbound Processor 



IPW$$VE - RJE, SNA: VTAM Exits 



IPW$$LH - RJE, SNA: Logon Processor No. 1 



IPW$$LN - RJE, SNA: Logon Processor No. 2 



IPW$$OC - RJE, SNA Outbound Compaction 

Mgr. 



IPW$$SM - Cross Partition Spool Mgr. 



(Reader Exit Routine) 



GETVlSArea 

- RJE, SNA Work Area 

- work area used during Printer setup 
processinq 



Pageable 

Storage 

(cont.) 



t 



VSIZE 
(cont.) 



GETVIS= ALLOC 
minus SIZE of 
7/EXECSIZE=" 
(also pageable) 



Figure 5.0. POWER/VS Partition Storage Layout (Part 4 of 4) 
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THE PERMANENT AREA CONTROL TABLES 



''%.,„ ,::^ 



Definition nnacro: IPW$DPA 
label PADS 



IPW$$NU 
label PASD 



T 



a: 

i 







Partition save area 
(refer to Section 4 
DOS/VS SADP. 
GC33-5380) 


DOS/VSSUP 


• 


DOS/VS Label 
Handling Area 


BG 


F4 


/ Permanent area 
F3 




'. Control address tablcj 
l-and constants (CAT) ^ 


F2 


POWER /VS nucleus 
routines 


F1 


Disk Management 
Block 







Summary of tables. For a 
detailed description of each 
field see Figure 5.4. 


Storage descriptor 
in dump 


Control address table 
Relocation constant 
External interface addresses 
Resource control block address 
Module control block addresses 
Task state values 
Permanent TCB address 
Task control address table 
Relocation list delimiter 
Module load address 
Service routine branch table 
Block length table 
Non-relocatable constants 
Statistical information 
General constants 
Translate tables 


CAT 



Figure 5.1. Organization of the POWER/VS Permanent Area and the Control Address Table 
(CAT) 

POWER/VS is shown in the F3 partition of a five partition system- 



How to Locate 



v_ y. 



The Control Address Table starts at displacement X"140' from the start of the partition 
in which POWER/VS is initialized. 

Appendix D shows the organization of the tables within this area as they are printed in a 
dump. It consists of a scale drawing which can be used as a template. If you have found 
the CAT in a dump, individual areas within the table can easily be identified by laying 
the table over the illustration. 
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THE PERMANENT AREA CONTROL BLOCKS 



These control blocks are initiated by phase IPW$$I2 and remain fixed in the permanent 
area until POWER/VS is terminated. The location of each block is kept in the CAT. Each 
block has a storage descriptor enabling easy identification in a storage dump. 



6K 



( 



Partition Save Area (as 
described in DOS/VS 
SADP, Section 4. part 2) 



File label area 



Control Address Tab'es 
and constants (CAT) 



POWER/VS nucleus 
routines 





Name of control block 


Storage 
descriptor 
in dump 


Figure number 




1 Wait control block 


WCB 


5.5 




Storage control block 


SCB 


5.6 


Message control block 


MMB 


5.7 


Disk management block 

• Resource control fields 

• File control fields 

• Record control fields 

• Master record area 

• Auxiliary account 
record area 

• Auxiliary queue 
record area 

• Master class table area and 
class list entry 


DMB 


5.8 



Figure 5.2. Organization of the POWER/VS Permanent Area with fixed control blocks 
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CONTROL BLOCKS DYNAMICALLY ALLOCATED IN THE FIXABLE AREA 



These blocks are dynamically constructed, depending on the tasks required at any given 
time. The organization of the. blocks relative to each other and the start of the fixable 
area cannot be truly illustrated. The figure, however, lists those blocks which are 
eligible to be in the fixable area. 



V„>' 



Permanent Area 






Pageable Area 



GETVIS Area 
(optional). 





Description of area 


Storage 
descriptor 


Pig. 


Task Control Block 
• Task Management Fields 
. Task Register Save Area 
. General Task Work Area, 

Linkage Register Save Area, and 

File Control Words 


TCB 


5.9 

5.10 

5.11 

5.12 


Command Processor Control Block 


CPB 


5.13 


2nd Linkage Register Save Area 


None 


5.14 


Physical Work Space 


None 


5.15 


Physical Data Record Area 


None 




Logical Data Record Area 


None 


5.16 


Modute Control Block 


MCB 


5.17 


Tape Control Block 


TBB 


5.18 


Page Control Block 


None 


5.19 


Buffer Cofftrol Word 


None 


5.20 


Partition Control Block 
• Device Table Entry 


PDB 


5.21 


Queue Record Area 


None 


5.22 


SLI Work Space 


None 


5.23 


Account Control Block 


ACCB 


5.24 


Account Work Space 


None 


5.25 


Reader Account Record 


None 


5.26 


List Account Record 


None 


5.27 


Punch Account Record 


None 


5.28 


Execution Account Record 


None 


5.29 


Line Account Record 


None 


5.30 


Session Account Record 


None 


5.30 


RJE.BSC Line Control Block 


None 


5.32 


RJE,BSC Buffer Control Area 


None 


5.33 


RJE.BSC Line Manager TCB Fields 


None 


5.34 


RJE.SNA Control Block 


SNCB 


5.36 


RJE.SNA Message Control Block 


MSCB 


5.39 


RJE.SNA Manager TCB Fields 


None 


5.40 


Generation Table 


GNB 


5.36 


CCB 


None 


5.42 


M ccw 


None 


5.43 


1 Separator Line Area 


None 


5.44 




Diskette Work Space 


OEWS 


5.45 




Asynchronous Service Anchor Block 


ASWS 


5.47.1 




Service Request Block 


None 


5.47.2 




Assign/Unassign Work Space 


LUWS 


5.47.3 




3800 TCB Extension Area 




5.47.4 




Relationship Example 


None 


5,48 



Figure 5.3. Control Blocks dynamically allocated in the Fixable area 



%. 
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liE GETVJS 7\nx.A CONTROL BLOCKS AND POOLG 



The GETVIS area is an extension of the pageable area used to support RJErSNA. 
Its space requirements are calculated by IPW$$I2,, and contain the following: 

a. RMCB - remote control block 
plus the following GETVIS pools: 

b. Logon space - containing 
one SUCB, 

one LUCB, 

one WACB with one buffer^ 

and five LRCBs. 

c. SUCB and LUCB • control blocks^ containing one SUCB for each work station chained to 
a number of LUCBs (the number being equal to that of the maximum SESSLIM value 
specified in all PRMT macros at POWER/VS generation time. 

d. WACB - work area control block 

e. Compaction tables. 

The start address of each pool is contained in the SNA control block (SNCB) . 

Another portion of the GETVIS area is used as a work area during 3800 printer 
setup processing. The area is released when the setup is done. 
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Layout of the POWER/VS Data Areas 



CONTROL ADDRESS TABLE (CAT) 



Included by definition macro IPW$DPA for the permanent area. 

This table consists of a set of tables, addresses, and constants in the permanent area 
of the POWER/VS partition, used to link the component routines of the POWER/VS subsystem 
during execution. The format of this table as it is printed in a dump is shown below. 



00 


CAT Storage Descriptor 


Control Address J 


20 


Table 


CARL 


External Interface | 


40 


Addresses 


Resource Control Block | 


60 


Addresses 


Module Control Block Address Table | 


80 






Task State Values and Addresses of State 




AO 


Processing Routines 






1 Permanent 


CO 


TCB Addresses 


Task Control Address | 


EO 


Table 


FF 












Module Load Addresses 




J Service Routine Brianch Table 




180 














Block Length Table | CALC 


Lockword 


ICO 




Statis 


tical Information 






1 Fullword Constants 




220 


Translation Tables 



Figure 5.U. The Control Address Tables and Constants (Part 1 of 7) 
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Bytes 



Dec 



H 



Hex 
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Label of | Description/function of field 
field I 



Control address table 



h 



00-15 
16-19 
20-23 
2U-27 
28-31 
32-35 
36-39 
40-43 
44-47 



00-OF 
10-13 
14-17 
18- IB 
IC-IF 
2 0-23 
24-27 
28-2B 
2C-2F 



PASD [Storage descriptor (CAT) 

PAEB jPOWER/VS master ECB (refer to Appendix H) 

PAPA I Start address POWER/VS partition 

|.PAFA I Start address fixable area 

PAVA I Start address pageable area 

PAEN I End address POWER/VS partition +1 

PALS [Start address LTA 

PALE I End address LTA+1 

CAPB I Address of POWER/VS PIB 

L . 

Relocation constant 



h 



48-51 



30-33 



CARL 






I Relocation constant used by initiator to calculate the 
j relocation factor for addresses in the following tables. 
I (To enable POWER/VS to be loaded in any partition.) 
[Value = X'170'. The number of relocatable constants is 
[referenced by label CANN, 

External interface addresses 



h 



52-55 
56-59 
60-63 
64-67 
68-71 
72-75 



34-37 
38-3B 
3C-3F 
40-43 
44-47 
48-4B 



h 



CAAI [Attention interface 

CAPF [Page fault appendage 

CAHR [Hot reader routine 

CAGE [RJE CE appendage 

CAOO [SVC appendage 

CA90 I SVC 90/91 appendage 



-^ 






Spool management cross-partition XECB information, 

I 

[Internal reader cross-partition XECB 






76-79 
80-80 
81-83 



4C-4F 
50-50 
51-53 



h 



84-87 
88-88 
89-91 



54-57 
58-58 
59-5B 



h- 



ICXP [Internal reader XECB 

IPIK [Internal RDR user's PIK/TIK 

ICTA [XECBTAB ADDR Of ICR XECB 

I 

-I Spool /command manager cross-partition XECB 

SMXP [Spool/command MGR XECB 

SPIK I Spool/command MGR user's PIK/TIK 

SMTA [XECBTAB ADDR of SPM XECB 

-[selecting the internal RDR task and/or the spool/command 

I manager LST task 

I I 

92-95 [5C-5F | ICWL [ADDR POWER'S internal reader XECB 

63-99 [60-63 [ SPWL [ADDR POWERS S spool/command MGR XBCB 

100-100 [64-64 [ jWAITM list delimiter 

101-103 [65-67 I [Reserved, 

[Resource control block addresses. This table is collectively 
[referenced by label CAFR. The number of resources is referenced by 
1 label CANR. 



h 



104-107 
1108-111 

112-115 
1116-119 

120-123 
1124-127 

128-131 
I I 132-135 



68-6B 
6C-6F 
70-73 

7C-7F 
80-83 
84-87 



CAQC [Disk management block 

CAAC [Account control block 

CASC [Storage control block 

CAMM [Message control block (local) 

CARM [Message control block (remote) 

CASM I SNA control block address 

CAGP [General purpose work area 

CAAB I Asynchronous service anchor block 



Figure 5.4. The Control Address Tables and Constants (Part 2 of 7) 



J 
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136-139 
140-143 
144-147 
148-151 
152-155 
156-159 
160-163 
164-167 
168-171 



h 



Dec 



Bytes 

"T — 



Hex 



H 



f 



172- 
176- 
180- 
184- 
188- 
192- 
196- 
200- 
204- 
208- 
212- 
216- 



175 
179 
183 
187 
191 
195 
199 
203 
207 
211 
215 
219 



220- 
224- 
228- 
232- 
236- 



223 
227 
231 
235 
239 



88-8B 
8C-8F 
90-93 
94-97 
98-9B 
9C-9F 
A0-A3 
A4-A7 
A8-AB 



Label of | Description/function of field 
field I 

. X : . 

Module control block address table 



The addresses in this table are used by the disk services and are 
established when the POWER/VS disk files are opened at system 
start-up time.. 
+ --- 



AC-AF 
B0-B3 
B4-B7 
B8-BB 
BC-BF 
C0-C3 
C4-C7 
C8-CB 
CC-CF 
D0-D3 
D4-D7 
D8-DB 



DC-DF 
E0-E3 
E4-E7 
E8-EB 
EC-EF 



\ y 



i Ac c ount in g mo dul e 
|MCB queue file 
|MCB data file module 
IMCB data file module 
|MCB data file module 
|MCB data file module 
|MCB data file module 
|MCB private SSL 
|MCB system SSL 



CAAO 

CAQl 

CAD2 |MCB data file module 1 

CAD3 |MCB data file module 2 

CAD4 |MCB data file module 3 

CAD5 |MCB data file module 4 

CAD6 IMCB data file module 5 

CAL7 

CAL8 

Task state values and addresses of state processing routines 

These constants are used by the task management macro instructions 
to set values within the task selection fields of the task control 
blocks (except TMCW) . 

T ■ ' • ' 

TMCI I The task is inactive^ task not selected 

I Branch to TMIO 
TMCP I Page fault in process, *task not selected 

I Branch to TMIO 
TMCO I Wait for operator, task not selected 

I Branch to TMIO 
TMCL I Wait on locked resource, test lockword 

[Branch to TM3 
TMCF I Wait ofn LTA/PTA, test control blocks 

I Branch to Ty^SS 
TMCM I Wait on multiple posting, test control blocks 

I Branch to TM50 
TMCQ I Wait on class table posting, test control blocks 

[Branch to TM50 
TMCC [Wait on single posting, test control block 

I Branch to TM80 
TMCS I Wait on space posting, test control blocks 

I Branch to TM80 
TMCD I Immediate dispatch, dispatch the task 

I Branch to TM9 
TMCW jwait state. Used for WCB only. 

jwait routine. Branch to TM20. 
TMCR I The task is running, re- selection address 



TATM 
TAOC 
TAIT 
TALM 
TASP 



.y 



Permanent TCB addresses 



Wait control block 

Command processor TCB 

Initialization/termination TCB 

Line manager TCB 

Spool manager TCB address 



Figure 5.4. The Control Address Tables and Constants (Part 3 of 7) 
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— TT- 



h 



240-243 I 0F0-0F3 

I 

I 

244-247 |0F4-0F7 

I 

248-251 JOFB-OFB 



252-255 lOFC-OFF 

I 

256-259 1100-103 

I 

260-263 1104-107 

I 

|264-267 I108-10B 

268-271 I10C-10F 
1 



Bytes 



Dec 



Hex 



"+ +- 



Label 
field 



of j Description/function of field 



Task control address table 






CALM JTask identifying prefix (L) and the address of the TCB of 

I the line or SNA manager (or of the wait control block if 

I the line manager is not present). 
CASP I Task identifying prefix (J) and address of most recently 

I attached spool management TCB. 
CAOP I Task identifying prefix (O) and the address of the TCB of 

I the most recently attached auxiliary command processor (or 

I of the permanent command processor if no auxiliary command 

I processor presently exists). 
CARJ I Task identifying prefix (X) and the address of the TCB of 

I the most recently attached remote (RJE) reader/writer* 
CARW I Task identifying prefix (W) and the address of the TCB of 

I the most recently attached local writer task. 
CAEX I Task identifying prefix (E) and the address of the TCB of 

I the most recently attached execution processor task. 
CARR I Task identifying prefix (R) and the address of the TCB of 

I the most recently attached reader task. 



IX'FFOOOOOO" (list delimiter) 
+ X 

Module load addresses (listed as loaded in the pageable area) 
The first module is referenced by label CAFM. The niamber of 
modules is referenced by label CANM. The number of SNA modules is 
referenced by label CANS. 



H 



Command processor module 



272-275 



I 110-113 

«-L 



CACP 



j Command processor 



Reader task modules 



-H 



276-279 
280-283 
284-287 
288-291 
h 



"T 

jl 'I 4-1 17 
I 118-11B 
I11C-11F 
I 120-123 



CAPR (Physical reader 

CAPD I Put data record function 

CALR I Logical reader 

CASN I Scan and check parameter function 

Writer task modules 



h 



-H 



292-295 
296-299 
300-303 
304-307 



h 



I 124-127 
I 128-12B 
I 12C-12F 
I 130-133 
•+ 



CAPL j Physical list 

CAGD I Get data record function 

CALW [Logical writer 

CAPP I Physical punch 



h 

308-311 

312-315 

316-319 
320-323 

324-327 



-+ — 

1134-137 
I 138-13B 

I 

I 13C-13F 
1 140-143 

I 

I 144-147 
-J. 



Execution processor modules 



CAXR ! Execution reader 

CAXG I Get data record function (copy 2 refer to Section 3,, 

jXR/XW) 
CAXW [Execution writer 
CAXP [Put data record function (copy 2 refer to Section 3, 

i XR/XW) 
CAXJ |JECL analysis 



Figure 5.4. The Control Address Tables and Constants (Part 4 of 7) 
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Bytes 



H 



Dec 



Hex 



Label of | Description/function of field 
field I 



Queue manageraent modules 



328-331 
332-335 
336-339 
340-343 
344-347 



148-14B 
14C-14F 
150-153 
154-157 
158-15B 



h- 



CARQ 
CAAQ 
CANQ 
CADQ 
CAFQ 



348-351 
352-355 
356-359 
360-363 
364-367 
368-371 
■372-375 
376-379 
380-383 



+- 

15C-15F 
160-163 
164-167 
168-16B 
16C-16F 
170-173 
174-177 
178-17B 
17C-17F 



Misce 

CALU 
CAAS 
CAPS 
CAIC 
CAOT 
CATR 
CAER 
CAGE 
CAMS 



I Reserve queue function 

I Add to queue function 

]Get next from queue function 

I Delete from queue function 

I Free queue function 

X 

llaneous modules 



JLUB/PUB update function 

I Asynchronous service function 

I Print queue status report 

I Invoke command processor function 

I Open tape routine 

I Task terminator 

I 3540 Physical reader 

1 3540 OpeD routine 

[Message handler 



I 



V~ 

384-387 



Spool management option 



h 



180-183 jCASF 1 Spool manager 

The following modules are optional 



-1 
! 

1 



388-391 



184-187 



Remote job entry BSC module 

T " 

I Remote job entry 



CATM 



! 
! 
I 
1 



Reader exit module 



392-395 



188-18B 



CARE 



I User reader exit routine 



-+- 



Accounting modules 



396-399 
400-403 
404-407 



18C-18F 
190-193 
194-197 



h- 



CAPA I Put account function 
CAGA I Get account function 
CASA I Save account function 

X , . 



1 
1 
1 



408-411 



198-19B 



Source 
CASL 



library include module 



"-T- 



jGet SSL functi^on 



h 



412-415 
416-419 
420-423 
424-427 
428-431 
432-435 
436-439 
440-443 
444-447 
448-455 



f 



19C-19F 
1A0-1A3 
1A4-1A7 
1A8-1AB 
1AC-1AF 
1B0-1B3 
1B4-1B7 
1B8-1BB 
1BC-1BF 
1C0-1C3 



Remote job entry SNA modules 

T • •' 

CASO I SNA manager 

CAS2 ! SNA logoff processor 

CAS3 I SNA message processor 

CAS4 1 SNA message definition 

CAS5 I SNA inbound processor 

CAS6 I SNA outbound processor 

CAST |VTAM Exits module 

CASS (Logon processor 1 - IPW$$LH 

CAS9 I Logon processor 2 - IPW$$LN 

CASIO I Reserved 

X 






Figure 5.4. The Control Address Tables and Constants (Part 5 of 7) 
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r 




-T 


""T" '" "■ *^ '"' '" " ■ *' "" — — — — — i..^— ....«.«. «. ..m,.,m..mm..mmmm.mm.mm.mmmm.mm.mm^m,.mm.mmmm.-m,^mmmm ■« lii nil m iii iii Iji T ii ■ 1 


-1 


1 Bytes 


1 


1 




L___ 




-^ Label of | Description/function of field 




r 


— P 




1 Dec 


1 Hex 

«.j 


1 field 

1 ^_, 


1 


—J 




-J- — — 


— 1 -.^, 

1 Service 
1 


routine branch table 


•^1 






1 

|The branch instructions are used to transfer control from service 






1 


1 routine 

«.j ^^ ^. 


macro instructions to the appropriate service code* 


H 


J. m T- ilr 11, ■■ ....«» 


^j. 


T 


-T "" "** ^ "" *- ^ 


1 456-459 


1 1C8-1CB 


|TA00 


(Attach task 




1460-463 


I1CC-1CF 


|TD00 


1 Detach task 




1 464-467 


1 1D0-1D3 


ITMOO 


jTask selection 




1 468-471 


j 1D4-1D7 


|TS00 


1 Initial task entry 




1 472-475 


1 1D8-1DB 


IRMOO 


[Reserve resource 




1 476-479 


1 IDC- IDF 


|RM50 


[Release resource 




1 480-483 


1 1E0-1E3 


1 SMOO 


[Reserve work space 




1 484-487 


I1E4-1E7 


|SM50 


[Release work space 




1 488-491 


1 1E8-1EB 


|MM00 


[Message service (local) 




1 492-495 


1 1EC-1EF 


|MM50 


[Message service (remote) 




1 496-499 


1 1F0-1F3 


|DM00 


(Set write command code 




1 500-503 


I1F4-1F7 


1 


1 Disk service 




1 504-507 


1 1F8-1FB 


IDMIO 


[Set read command code 




1 508-511 


1 1FC-1FF 


1 


[Disk service 




1 512-515 


1200-203 


|TP00 


[Tape service 




1 516-519 


1204-207 


ITROO 


[Timer service 




1 520-523 


I208-20B 


|VA00 


[Validation service 






1 


— X«. «.—-«,-«,--.«- , 


JL 






"1 ^ 












] Block length table 
1 








1 

|The table is used by the IPW$RSW macro instruction to identify the 




1524-527 


~+ 

1 20C-20F 


1 size of 

-+ 

IBLBF 


work space required to accommodate certain control blocks. 




[Data buffer - set by INIT (amount of storage required to 








1 


[accommodate the data block) 




1 528-531 


1210-213 


|BLDB 


[Data block - set by INIT (size of record written to di$k) 




{. 


•f 


-+ 


-X 


—■ 1 


1532-535 


~+ 

1214-217 


[Miscellaneous non-relocatable constants 
1 




-T 

ICALC 


[Line control block address 




1 536-539 


I218-21B 


1 


|BSC,,RJE lockword 




j. 


_.| 


~+ 


.i..„^ ^ ^ ^ ^ «-,--«-•.«•- -„-.-•--.«.«„-.-.«««« 






*"1 


1 540-541 


-+ 

1 21C-21D 


[Statistical information (refer to Appendix E) 
1 


-^ 


-f 

1 NRRE 


[Highest BSC remote ID 


1 542-543 


1 21E-21F 


|NRLI 


[Number of BSC lines 




1 544-547 


1 220-223 


INRQR 


[Total number of queue records 




1548-551 


1 224-227 


|NRQF 


[Number of free queue records 




1 552-555 


i 228-22B 


1 NRQM 


[Maximum number of queue records used 




1556-559 


I22C-22F 


|NRTR 


[Total number of tracks data file 




1 560-563 


1 230-233 


|NRTW 


[Number of times waiting for storage 




1564-567 


1234-237 


|NRPG 


(Total number of pages allocated 




1 568-571 


1 238-23B 


1 NRPC 


[Current number of pages allocated 




1572-575 


I23C-23F 


|NRPM 


(Maximum number of pages allocated 




1 576-579 


1 240-243 


1 NRTC 


(Current number of tasks 




1 580-583 


1244-247 


JNRTH 


[Maximum number of tasks 








j Fullword 1 constants 




[. . 


~.| 


-+ 


_+ . ^ 


— ^ 


1584-587 


I248-24B 


|CF01 


(F'l* 




1 588-591 


I24C-24F 


|CF04 


|F'4' 




1592-595 


1250-253 


|CF0 8 


[F'8' 




1 596-599 


1254-257 


ICFIO 


[F'lO' 




1 600-603 


I258-25B 


|CF24 


|F'24' 




[ ^ 


•.JL 


-X 


«x . 


—.J 



Figure 5.4. The Control Address Tables and Constants (Part 6 of 7) 
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J. .. . . ^ . — _^ , — . . , 

I Bytes I I 

j. — -, -(Label of i Description/function of field 

I Dec I Hex | field | 

I I I Translation tables 
|. + + .-r- 



--! 



I 1604-859 125C-35B | TRTB 

I i I 

I ! I 

I 1860-1115 I35C-45B | TRTC 



I 



I 

.X- 



JThis table is used to scan sequences of blank characters 
I for the first non-blank character and also as a source of 
[blank characters for various program purposes. 
[This table is used to scan sequences of non-blank 
[characters for the first blank character and also as a 
I source of zero characters for various program purposes, 
-i . . . . 



..^ 



Figure 5.4. The Control Address Tables and Constants (Part 7 of 7) 

How to Locate 

Refer to Figure 6.1 in Section 6. 

WAIT CONTROL BLOCK (WCB) 



Tne wait control block is a skeleton task control block used to delimit the task 
selection list. The wait control block occupies locations in the permanent area of the 
POWEiWS partition. 



■ 32 (dec) bytes - 



WCB 


Storage Descriptor 


Reserved 


TMTN 


TMPF 


TMSF 



y 



Bytes 

-, ^— — 

Dec I PI. ex 



~~ --^i —^ 

00-15 lOO-OF 



16-19 110-13 

20-23 114-17 

24-27 118-lB 

28-31 IIC-IF 



Label of I Description/function of field 

field 1 



TMSD 



TMTN 
TKPF 
TMS F 



.^ . ^^ 

I Storage descriptor CWCB) 
.^ ^ «« H 

I Reserved 

[Address of TCB belonging to task with highest priority in TSL 

I Page fault request word - always zero 

[Task selection field 



E6 



Address of routine that tests if a POWER/VS event is posted in nnain ECB. 
If not, it places the POWER/VS partition in wait state by issuing an SVC7. 



— J 



Figure 5.5. Wait Control Block 



How to Locate 



Refer to Figure 6.1 in Section 6. 



^. 
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r 



STORAGE CONTROL BLOCK (SCB) 



Definition macro: IPW$DSC 



The storage control block is used to control access to the storage iranageinent routines 
and to allocate storage pages as required by the routines. The format of the table as it 
is printed in a dump is shown below: 



-32 (dec) bytes - 



SCB 



Storage Descriptor 
1 h- 



SCLP SCFP SCEB SCLK 

H 1— 1 



R14 R15 RO R1 R2 R3 

1 1 1— . I I 



R4 R5 
i 



SCBT Storage assignment table 



I 

SCPF 
I 



SCFB 



SC LB 



FFOOOOOO 



Reserved 



Bytes 


1 


1 






J Label 


of 1 Description/function of field 




T~ 




Dec 


1 Hex 
J ^ 


Ifield 


1 

1 _ _ 




*"T~ • 


"~*"t 


... ^ - 


00-15 


lOO-OF 
J. - — 


ISCSD 


[Storage descriptor (SCB) 

. _i ■ _ . « -. — 




~T • 


— — T "*" 


.- — ^- — - - — -..«.- — - 


16-19 


110-13 


ISCLP 


1 Last permanent page 


20-23 


114-17 


|SCFP 


1 First fixed page 


24-27 


118-lB 


ISCEB 


[Event control block 


28-31 


|1C-1F 


|SCLK 


1 Lockword 


32-35 


120-23 


|SCRE 


|Task register 14 A 


36-39 


124-27 


ISCRF 


1 Task register 15 J 


40-43 


I28-2B 


|SCRO 


JTask register | 


44-47 


|2C-2F 


|SCR1 


|Task register 1 > ^ 


48-51 


130-33 


|SCR2 


|Task register 2 I 


52-55 


134-37 


|SCR3 


JTask register 3 j 


56-59 


I38-3B 


|SCR4 


[Task register 4 J 


60-63 


I3C-3F 

1 


|SCR5 
1 


JTask register 5 . 

1 ^ _ 




~T ~ 


— t 


^ — _ — - 


64-127 


|40-7F 
^ 1 


jSCBT 
J , 


1 Storage assignment table ^ 

. _x — — — — 




T 


— t 


-^ — - -. - - 


128-135 


180-87 
1 


|SCFB 
1 


iConstant to initialize the first BCW (see Figure 5.20) in 
|a new fixed page in the fixable area. 


136-143 


I88-8F 

1 
— J. — 


1 SCLB 

1 
_i 


[Constant to initialize the last BCW in a new fixed page in 
jthe fixable area (see Figure 5.20) 

. _L ^ -.-.- — - — — — 




~T - - * 


— t 


^ . -. -^ - - 




1 


ISCPF 
^_'i 


1 Page fix/free work area ^ 

1 « . _ «. ^ .^ 




""f"" 


— t — 


— ^ — .^ 


144-147 


190-93 


1 


1 Page virtual address ^ 


148-151 


194-97 


1 


iPage length (-1) ^ 


152-155 


I98-9B 


1 


|End-of-list indicator (X' FFOOOOOO' ) 


156-159 


I9C-9F 


1 


1 Reserved 




-X 


X 


X : 



^Hyiu^' 



Figure 5.6. Storage Control Block 

> Since the storage management routines are used to provide register save areas for 
task use, the storage control block must contain a register save area for use by the 
storage management routines. 
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^ The storage assignment table is like a map of the fixable area within the POWER/VS 
address space in which each page control byte represents a single page of address 
space. Each byte within the table takes one of four values. 

XVOO* Page free (and not last page) 

X'40' . Page free (and last page) 

X'80' Page in use (but not last page) 

X'CO' Page in use (and last page) 

The storage assignment table is defined with all pages free and is properly 
initialized by the POWER/VS start-up routines to reflect the amount of real storage 
available to the POWER/VS partition at that time. 

3 Three fullwords used as a work area by the page-fix and page-free routines. The 
first word is used to contain the address of the first byte of the page to be fixed 
or freed; the second word contains binary 2047 (page size minus one) ; and the third 
word contains X'FF* in its high-order byte to act as a list terminator. 

How to Locate 

Refer to Figure 6.1 in Section 6. 

MESSAGE CONTROL BLOCK (MMB) 






Definition macro: 



IPW$DMM 



This block provides support for the macros IPW$WTO and IPW$WTR. A routine issuing one of 
these macros will invoke message services. A message to be printed on SYSLOG will be 
passed to the MMB by means of the message request word in the TCB. The MMB also contains 
the channel program (CCB and CCW) to execute the I/O to the console. If a reply is 
necessary the channel program in the MMB will execute the necessary I/O. The message 
service will move the reply to an area addressed by the reply request word in the TCB for 
the task using the routine that issued the IPW$WTR macro. (See also TCMW and TCAW fields 
in the TCB,, Figure 5.11.) 

The format of this block as it is printed in a dump is shown below: 



- 32 (dec) bytes 



^ 



" T" -T 1 

MMB Storage Descriptor 


Work Area 


Reserved 


Lockword 




Register Save 


^rea 






CCB 


Write CCW 


• Read CCW 








Message output 


area, 72 (dec) bytes 












Reply input area, 72 (dec) bytes 




Reserved 











Figure 5.7. Message Control Block (Part 1 of 2) 



Ly 
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r 


~— "~— 


""T 


y 






1 


1 Bytes 


1 


I 








[. 


~T 


~^ Label 


of] Descri 


ption/function of field 




1 Dec 


1 Hex 


[field 


i 








1- ^— 


-| 


-+ 








_ — — ^ 


1 00-15 


1 00- OF 


1 MMSD 


1 Storag 


[e descriptor CMMB) 




1 


J 


J 


j ^ 






J 


r 


~i 


~T 




.«.«_-_—_»,—-_« 




— ^«.^^— . -»«. — .^— .^ 


116-23 


110-17 


IMMWW 


|Work area 






1 24-27 


118-lB 


1 


[Reserved 






128-31 


IIC-IF 


IMMLK 


JLockword 






1- 


-+ 


~+ 


1 






^ 


1 


1 


IMMSV 


[Register save area 




h 


~f 


-+ 


-j 


. 


» ; 


\ 


132-35 


120-23 


IMMRE 


1 Saved 


register 


14 




1 36-39 


124-27 


1 MMRF 


j Saved 


register 


15 




|ao-43 


(28-2B 


|MMRO 


1 Saved 


register 







1 aa-47 


1 2C-2F 


JMMRl 


1 Saved 


register 


1 




148-51 


130-33 


|jyiMR2 


[Saved 


register 


2 




1 52-55 


1 34-37 


|MlviR3 


1 Saved 


register 


3 




156-59 


I38-3B 


|iyiMR4 


1 Saved 


register 


4 




160-63 


I3C-3F 


|MMR5 


1 Saved 


register 


5 




164-67 


140-43 


|MMR6 


1 Saved 


register 


6 




1 68-71 


1 44-47 


|MMR7 


1 Saved 


register 


7 




172-75 


|48-4B 


|MMR8 


[ Saved 


register 


8 




1 76-79 

1 


1 4C-4F 

_I ^^ 


1 jyiMR9 
_j .^_ 


[ Saved 


register 


9 


\ 


r 

1 

L — 


1 

1 

J 


|MMCB 
J. — 


[CCB 

i«.^ 






.^^^ . 1 


r 


"T ' — 


— [ 




"——'—*'——'——" 




.^^« j 


t 80-81 


1 50-51 


|MMCT 


1 Residual count 






182-83 


(52-53 


|MMCM 


1 Communicate on bytes 




1 84-85 


1 54-55 


|MMST 


[Status bytes 






186-87 


156-57 


|MMLU 


jLUB identifier 






1 88 


|58 


|MMCA 


[Flags 








|89-91 


|59-5B 


1 


] Channel program address 




1 92-95 


1 5C-5F 


1 


(DOS/VS internal use 




|. 


~f 


-+~ 


1 





. — , 




1 . 


1 


|MMCH 


1 Channel program 




L 


1 


^ 1 


-_ J- 








r ^'-' 


~T 




1 


*—'—'—' "~ —"—"— " 


"■—'—'—"——'—"—'—'——'—'———*—' ——■-<——» — ■ ■"■' "" ■"•-"- 




1 96-103 


1.60-67 


|MMWT 


[Write 


CCW 






1104-111 J68-6F 


|MMRD 


[Read CCW 






L^^^^^^. 


1 


—,4.—— .——.—.- 


„— — JL— .«.«_^^- 










-T "• 






— .«. — — "■ 


_--— ^-- --.—•-- --.-«*»^-- «•«-.-»-——«-------■--.--—.•--.---- *.— 




1 112-1831 70-B7 


IMMMA 


[Message output 


area 




L __ 


_j 


1 


_^ 1 «.^«»-. 








r~ 




~T 






~ —'—'—*—''——'—'—'—'—■"—'**■ "~— ■'"■—' —'—'"~''~' '"''*"""' "~"~'"*~ """"^ ■~''~ 


"*"~ "1 


|184-255|B8-FF 


|MMMI 


[Reply 


input area 




1 256-263|100-107| 


1 Reserved 







Figure 5.7. Message Control Block (Part 2 of 2) 



Plow to Locate 



Refer to Figure 6.1 in Section 6. 
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D I SK MANAGEMENT B LOCK (DMB ) 



Definition macro: IPW$DQC 



The disk management block area is used to control access to the POWER/VS queue file- It 
is located in the permanent area of the POWER/VS partition. 



The disk management block is divided into the following areas; 



Resource control fields 
File control fields 
Record control fields 
Master record area 
Auxiliary account record area 
Auxiliary queue record area 
Master class table area. 



Ky 
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The format of the table as it is pjrinteo! in a dump is shown below: 



32 (dec) bytes 



Hex 

00 
20 



EO 
100 



ICO 



280 



320 



360 



DMB Storage Descriptor 



Resource Control Fields 



File Control Field (192 bytes) 



Record Control Fields (32 bytes) 



Master Record Area (184 bytes) 



Auxiliary Account 
Record Area (8 bytes) 



Auxiliary Queue Record Area 



Reserved 



Reserved Class 0(BG) ClassKFI) Class 2(F2) Class 3(F3) Class 4(F4) Class 5(F5) Class 6(F6) 



-I 1 1 1-. 



- Reserved - 



1 — 

-^ Class A Class B ^- 



H 1- 



<4 etc. - 



—1 i 1 

-► Class X Class Y Class Z 



• Reserved 



-Reserved - 



Class A Class B ^_ 

I L_ 



Class Y Class Z 



■ Reserved - 



-^ Class A Class B Class C 

I I 



->• Class X Class Y Class Z 

I I I 



Reserved 



> Class 
Table 



List 
> Class 
Table 



Master Class 
y Table Area 
(440 bytes) 



Punch 
y Class 
Table 



I Figure 5.8. Disk Management Block (Part 1 of 9) 
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00-15 
16-23 
24-27 
28-31 



h 



Bytes 



Dec' 



Hex 



00-OF 
10-17 
18-lB 
IC-IF 
~f 



32-35 
36-39 

ao-87 

88-95 

96-99 
100-103 
104-135 
136-167 

168-223 



224-231 
232-235 
236-239 
240-247 
248-251 
252-255 



h 



Resource control fields 



They are used to manage the resources contained within the DMB 

QCSD I Storage descriptor CDMB) 

I Reserved 
QCEB I Event control block 
QCLK jLockword 

File control fields 



20-23 
24-27 
28-57 
58-5F 

60-63 
64-67 
68-87 
88-A7 

A8-DF 



E0-E7 
E8-EB 
EC-EF 
F0-F7 
F8-FB 
FC-FF 



Label of I Description/function of field 
field I 



-^ 



They contain parameters relating to queue file^ data file, and, if 
used, private and system SSL 



QC#R* 
QC#T* 
QCSC 



DC#R 
DC#T 
DCTR 
DCSC 



Number of records/track queue file ^ 
Number of tracks/ cylinder queue file ^ 
Queue file sector table 
Reserved 

Number of records/track data file ^ 
Number of tracks/cylinder data file ^ 
Track group control table 
Data file sector table 

Reserved for future use 



-+- 



Record control fields 



They contain information used to read and write records to and f ro n 
the master record area and auxiliary queue record area. 

+ T 



QCMW I Master record seek address (MBBCCHHR) 

QCMA I Real master area address 

QCMV I Virtual master area address 

QCQW ! Queue record seek address (MBBCCHHR) 

QCQA I Real auxiliary queue record area address 

QCQV I Virtual queue record area address 



Master record area 



-H 



The master record is written as the first physical record within J 
the queue file extent. During POWER/VS execution a copy of the j 
master record is maintained in this area. Whenever this copy is | 
updated a replacement master record is at once written to the queue] 
file so that, in the event of a failure of the system, warm start 1 
information can be recovered from the direct access device in ! 
question. | 
. ^_^ ^ 

256-263 1100-107 | MRDY [Date j 

1 ! 

I These eight bytes contain the date of POWER/VS execution | 

I in the format chosen at system generation (dd/mm/yy or j 

]mm/dd/yy). j 



.-/ 



I Figure 5.8. Disk Management Block (Part 2 of 9) 
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Dec 



Bytes 



Hex 



Label of 
field 



Description/function of field 



-^ 



264-267 



h 



108-lOB 



MRST 



POWER/VS Start time 

These four bytes contain the start time of .POWER/VS 

execution in packed decimal format. 



-^ 



268-271 
272-275 



lOC-lOF 
110-113 



Reserved 



f + 



MRDB 



H 



h 



276-279 



114-117 



MRTG 



Data block size 
This fullword contains a fixed-- point binary value 
representing the data block size of the data blocks within 
the data file. This is the length of the physical records 
written to the data file* 
+ ^ 

Track group size 

This fullword contains a fixed-point binary value 
representing the number of tracks within each track group 
within the data file. 






280-283 



118-11B 



MRVM 



Version and modification level 

four numeric characters representing the version 

and modification level of POWER/VS used. 



-H 



h 






284-289 



11C-121 



Reserved 



Programming Note ; ine following 6 switch bytes preserve the 



290 



122 



MRSI 



291 



123 



options established by the POWER/VS user at the time he generated 

his version* 

^ ^ 

(Source library switch 

i This byte contains a single alphabetic character 

I representing the source statement sublibrary to be 

] associated, unless otherwise specified, with any JECL SLI 

I statements encountered in the read queue. 

I .. ^ . ^ ^ 



MRJA jjob accounting switch 

[This byte contains a single alphabetic character; the 
I character A indicates that POWER/VS job accounting is 
[required; a blank character indicates that POWER/VS 
I accounting is not required. 






292 



124 



I Reserved 



293 

h 

294 



I- 

295-303 



125 IMRLG ILOG option switch (set to character L if JLOG=YES and 
1 blank if JLOG=NO) 

126 |MRTT I Termination status. Contains character A for incomplete 
I session or abnormal termination. Otherwise, it contains 
I character N, meaning normal termination. 
I Note ; It will contain an A during the session. 

12 7-12F I [Reserved for future use 

Programming i:Qote ; The following 14 bytes contain standard POWER/VS 



default values used when new queue records are created. 



-H 



304-311 



130-137 



MRNM I Default job name 

] These eight bytes contain the character string 'AUTONAME' 
I used as a default job name. 

X . ! . J 
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Bytes 



Dec I 



Hex 
312-313 1138-139 



Label of 
field 



MRNO 



Description/ function of field 



Master job number 
This halfword contains a fixed-point binary value 
representing the next job number to be assigned by 
POWER/VS. It is incremented by one each time it is used. 



-H 



Master queue identifier 

This byte contains the alphabetic character M to show that 

this is the master record. 



314 



13A 



MRQI 






315 



13B 



+ 

MRCL 



+ 



Default class attribute 

This byte contains the alphabetic character A representing 
the class attribute to be given by default to each RDR 
queue entry created within POWER/VS. 



316 



13C 



MRPY 



317 



13D 



Default priority attribute 

This byte contains numeric character 3 which defines the 
priority attribute to be given by default to each queue 
entry created by POWER/VS. 
+ 



H 



318-319 



13E-13F 



MRCN 






Default cancel code 

This byte contains the hexadecimal characters X' 10* 
representing normal end of job and task. 
+ 



I Reserved 



-H 



Programming Note ; Next 16-byte field contains the master line 



table* consisting of system default values used to analyse space 
and skip operations during printer control carriage simulation. 



320-343 



140-157 



MRLT 



[Line table 



Programming Note ; Next 20 bytes contain the master list values. 



which will be inserted by default in list queue records, unless 

overridden by a JECL LST statement. (Values are set by IPW$$I1 

using those specified by user during POWER/VS generation [JSEP=, 
RBS=, STDLINE=3) 



-H 



344-359 
344 



58- 
58 



167 



MRLV 
MROP 



345-346 

347 

348-351 

352-355 

356-359 

360-363 



59-15A 

5B 

5C-15F 

60-163 

64-167 

68-16B 



|X'80' 
|.X'40' 
|X»20' 



h- 



[Master list values 

[Option byte 

jx'Ol' - 3540 feed option 

|X"02' - Multiple channel 12 option (see POWER macro) 

- Clear printer at EOF 

- Mark form option for separator pages 

- No separator pages between copies 
I Reserved 

[Number of separators 
I Records before segmentation 
[Records before message 
[Record^ before next message 
I Reserved 

Programming Note ; Next 20 bytes contain the master punch values. 



LVSP 
LVBS 

LVBM 
LVBN 



which will be inserted by default in punch queue records, unless 
overridden by a JECL PUN statement. (Values set by IPW$$I1 using 
those specified by user during POWER/VS generation. [JSEP=,, RBS=, 
STDCARD=] ) 



I Figure 5.8. Disk Management Block (Part 4 of 9) 
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384-391 1180-187 1 MRAS 



408-415 

I- 

416-439 

F 



Bytes 

-P 

Dec I Hex 



I 



364-366 I16C-16E 
367 |16F 
368-371 1170-173 
372-375 1174-177 
376-379 I178-17B 
380-383 ]17C-17F 
+ 



-(Label of I Description/function of field 
field I 
^ + 

I Reserved 
PVSP I Number of separators 
PVBS j Records before segmentation 
PVBM (Records before message 
PVBN [Records before next message 

I Reserved 



392-393 1188-189 
I 



394-407 



1 18A-197 

-f 

] 

I 198-19F 






Programming Note ; Next 10 bytes contain account file values 



-H 



[Account file seek address (M^BCCHHR) 

I Contains the direct access storage seek address of the 

I last record in the POWER/VS account file. 



MRAZ i Account file record maximum size 

I Binary value representing the length of the longest recora 

I so far written to the account file. 
+ . ^ 

I Reserved 



Programming Note ; Next 32 bytes contain free queue pointers 



MRQF 



[First record in free queue (MBBCCHHR) 



— i 
— 1 



I 1A0-1B7 
-+ 



I Reserved 
.X 



h 



-f 

I 1B8-1BF 



Auxiliary account record area 

This area actually overlaps the auxiliary queue record area, 
because the accoimt record consists of the first part of the queue 
record which is built in that area. All account records ejccept 
execution account are transferred from here to the account file as 
standard variable length records. 



-1 



440-447 



ACPR j Block and record length 

I 

I This record control field is used for sequential access 

[method. 



-1 



Auxiliary queue record area (184 bytes) 

This area is required as a work space for an additional queue 
record (see Figure 5.22 and description Queue Record Area (QRA) ) . 
For example, for updating class chain addresses during the add to 
queue function. The first part (103 bytes) of the Q record con- 
tains body fields (information pertinent to this particular queue 
entry and the user job which created it) . 



448-455 I1C0-1C7 



QCDY 



[Date in format specified at SYSGEN (mm/dd/yy or dd/mm/yy) 



456-459 I 1C8-1CB 



QCST [Operation start time, in packed decimal 
I (OHHMMSSF; F = sign) 



460-463 jlCC-ICF 



QCET 



j Operation end time (OHHMMSSF; F = sign) 



H 



464-479 



J1D0-1DF IQCUI 
.+ + 

I1E0-1E7 IQCNM 



I 



I 16 bytes user information 

I _ — — _ — ^ 

I Job name 

[Job name associated with this particular POWER/VS or 
|DOS/VS job. If no job name is provided by the user the 
I default value AUTONAME is set into this field. 



480-487 
Figure 5. 
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Dec 



Bytes 



Hex 



488-489 



490 






491 



1E8-1E9 



1EA 



QCNO 



±. : X. 

*QCQI 



1EB 



Label of 
field 



QCCN 



Description/function of field 



j 



Job number 

Contains a binary job number assigned to the job upon its 
entry into the system and thereafter available for further 
identification of jobs with a common job name. 

. .«-- ..-^^.^.^ — , J 

Queue record identifier 

R = read queue record 
L = list queue record 
P = punch queue record 
F = free queue record 
D = dummy queue record 



POWER/VS cancel codes 
Cancel Code Condition 



-H 



X' 


10' 


X' 


20' 


X' 


30' 


X' 


40' 


X' 


50' 


X' 


60' 


x« 


70' 



Normal end of POWER/VS job or task ^ 

PCANCEL has been issued 

PSTOP has been issued ^ 

PFLUSH has been issued 

PDELETE has been issued 

PFLUSH has been issued via RDREXIT 

Canceled due to I/O error 



— ^ 



492 



1EC 



QCRJ 
QCDT 



Line identifier/device type 



493-495 



1ED-1EF 



h 



QCCU 



+_ ^. 

Channel and unit (line address) 






496 



1F0 



QCFJ 



From-terminal identifier 



497 
H 

498 






1F1 
1F2 
1F3 



QCTJ 



499 



QCCL 
QCPY 



To-terminal identifier 
+ 



Class (default = A) 






^ 

Priority (default = 3) 

This single byte contains the priority value (numeric to 

9), assigned by the user to this job operation. 



500-503 



1F4-1F7 



QCNR 



H 






504-505 



1F8-1F9 



QCNT 



|.„. f ^^ . + 



506 



1FA 



QCSN 



Record count 

Binary counter that represents the number of input or 
output data records associated with the read, list,, or 
punch operation (data transfer and control operations). 

Number of tracks for output storage 

Binary counter recording the number of tracks within the 
data file used to contain data input or output for this 
particular job operation. 

Job suffix number 

Binary job suffix number assigned to each successive 
operation (read, list, or punch) performed on behalf of 
the job. It may be used to identify output sets produced 
by jobs handling segmented output. 



507 



1FB 



QCNC 



Number of copies 

This single byte contains a binary value indicating the 
number of copies of printed or punched output that are to 
be produced when the output is processed by the writer 
tasks. It has ny use within input-related queue records. 



J 
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h- 



Bytes 

T- 

Dec I Hex 



508-511 



512-515 



516-517 



— f 



518-519 
520-523 



1FC-1FF 



200-203 



204-205 



206-207 



208-20B 



-"+ 



Label of 
field 



QCFI 



QCNA 



QCNP 



QCNE 
QCLC 



+ 

Number of extra pages 
4 ^ 

Line/card counter (data transfers only^ see QCNR) 



Description/function of field 



Forms identifier. Alphameric forms or card identifier of 
any special stationery or card stock to be used when 
creating the physical output from the job, A blank value 
indicates that no special requirement exists. The field 
has no use within input-related queue records. 

Number of additional records 

Number of pages (number of skips to channel 1) 



-1 



-H 



-H 



524-527 



20C-20F 



QCRR 



Restart page counter (used when PRESTART command given) 



528 
529 
530 
531 



210 



QCCR 



211 



212 

+ 

213 



QCDI 
QCDP 
QCSP 









532-535 



214-217 



QCBS 



h 



Copies remaining (used when PRESTART command given) 

Not used 
4 ^ 

Disposition (default = D) 

Number of separators. Binary value indicating the number 
of printed output separators to be produced. It has no 
use within input-related queue records. 

Number of records before segmentation (count driven j 

segmentation) 



H 



536-539 



218-21B 



QCBM 



h 



Records before message. Binary value representing the 
maximum number of list or punch data records that is to be 
tolerated by this job. When the record count exceeds the 
maximum value a warning message is output to the system 
operator. 



540-543 



21C-21F 



QCBN 



-1 



Records before next message. Additional number of list or 
punch data records that is to be tolerated by the job each 
time the record count exceeds the maximum value specified 
in the preceding field and the system operator elects to 
continue execution of the job. 



544-545 



220-221 



QCER 



Physical 3540 device address (packed) 



H 



546-547 

548-551 

j. . 



222-223 
224-227 



QCJ# 
QCCP 



^^4 ^^J-^^. .«.-. 



Saved job number for accounting 
Compaction table name 

3800 Printer Control Information 






h 



552-555 

556-563 

564 

565 

566 



228-22B 

22C-233 

234 

235 

236 



L. 



QCFL 
QLCG 
QLTC 
QLC1 
QLPS 
QLBR 



Flush identifier 

Copy groups 

Total number of transmission 

Current copy group index (restart purposes) 

Paper status (3800 only) 

C*B' - burst threading 



567 
568-571 



237 
238-23B 



QLOP 
QLCS 



Option byte 

X'20' - no separator pages between copies 

Reserved for future use 



,572-583 I23C-247 I 
L 1 .--1. 



I Unused 
-1 
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h 



h 



Bytes 



H 



Dec I Hex 



Label of I Description/function of field 
field I 



584 

585 
586 



248 



+- 

249 



587-599 



600-607 



608-615 



h 



616-623 



624-631 



632-639 



640-1023 
640-787 

788-937 

938-1083 

1084-1081 



+ 

QCFS 



24A 



258-25F 



260-267 



268-26F 



270-277 



278-27F 



285-3FF 
280-313 

314-3A7 

3A8-43B 

43C-43F 



The second portion (56 bytes) of the queue record contains control 
fields (information relating to the status of the queue record and 
to its position within the POWER/VS queues) . 



QCXS 



+ 



First in set switch 
+ 



QCSG 



QCNS 



QCQP 



QCQN 



+ 

QCDF 



+ 



Execution switch 

X = job in execution 

b = job not in execution 



— ^ 



Segmentation type 
C = count driven segmentation 
P = program driven segmentation 
D = data driven segmentation 
b = no segmentation 



■-i 



Reserved 



Next record in set. (MBBCCHHR) » 

M = index in module control block address table in CAT 



—i 



Pointer to previous queue record (MBBCCHHR) ^ 
M = index in module control block address table in CAT 
The meaning of this pointer depends on the value of the 
contents in field QCFS. See Figure 5.48, part 9. 






H 



Pointer to next queue record (MBBCCHHR) ® 
M = index in module control block address table in CAT 
The meaning of this pointer depends on the value of the 
contents in field QCFS. See Figure 5.48, part 9. 

Seek address of first data block (MBBCCHHR) 
M = index in module control block address table in CAT 
Seek address of the first read, list, or punch data block 
associated with the input or output described by this 
queue record. 



I Reserved 



-H 






Master class table area 

Defines the status of the POWER/VS queues. 



QCCT 
CTRT 

CTLT 

CTPT 






I Reader class area (37 entries, that is,, 1 dummy entry and 

I 36 entries 0-9 and A-Z) 

I List class area (37 entries, that is,, 11 dummy entries and 

I 36 entries A-Z) 

I Punch class area (37 entries,, that is, 11 dummy entries 

I and 36 entries A- Z) 

[Reserved 

I 

|The area layouts are shown in the dump format figure,. 
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Bytes 



Dec 



I Hex 



{Label of 
Ifield 



JDescription/function of field 



f- 



Each entry is defined as a class list entry (DSECT=CTDS) 
and consists of the following two 2- byte fields: 






• Relative record number of first queue record 
in last queue set in this class chain 

- Relative record number of first queue record 
in queue set in this class chain 



I The high^order bit in the last field indicates whether 
I there is a queue entry in this class that can be 
I dispatched. 

(See Figure 5,48 for an illustration of this 
I relationship, ) 

[Entries in the table also act as ECBs for the class chains 
(refer to Appendix D) . 



I Figure 5.8. Disk Management Block (Part 9 of 9) 



( 



^jfiw-^^.^ 
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4' 

( 



c 



^ This fullword contains a fixed-point binary value ^ representing the number of records/ 
per track characterising the DASD on which the file is located, 

^ This fullword contains a fixed-point binary value/ representing the number of tracks 
per cylinder characterising the DASD on which the file is located, 

3 This code indicates that the corresponding queue entry was not affected by an abnormal 
POWER/VS termination. The DOS/VS jobs associated with the queue entry, however, could 
have been canceled via DOS/VS. 

*♦ The PSTOP cancel code will not be stored in an account record if the EOJ option was 
specified with the PSTOP command, 

5 Refer to note (^) in the description of the queue record area, where the contents of 
equivalent fields QRFS, QRNS,^ QRQP# and QRQN are explained. 



TASK CONTROL BLOCK (TCB) 



( 



Definition macro: IPW$DTC 

Each POWER/VS task is equipped with a task control block which is created in fixed 
storage and is used to establish the identity of the task and to preserve its status when 
it is not in active control of the central processor. 

The TCB is divided into the following main areas: 

• Task management fields 

• Task register save area 

• General task work area, linkage register save area, and file control words 

Format of the TCB as it appears in a dump: 



- 32 (dec) bytes - 



HEX 
000 



040 



OAO 



T" 1 ~l -1 ' 1 ^ 1 1 

Task Management Fields (see Figure 5.10) 


Task Register Save Area (see Figure 5.1 1) 






General Task Work / 
Linkage Register Sav 
File Control Words 
(see Figure 5.12) 


Uea, 

e Area, and 











Figure 5,9. Task Control Block (Part 1 of 2) 
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Wheri the TCB belongs to a command processor task, the general task work area, linkage 
register save area, and file control words are replaced by command processor control 
fields (see Figure 5,14), when it belongs to a BSC line manager task, these fields are 
replaced by BSC line manager control fields (see Figure 5. 34), and when it belongs to an 
SNA manager task, these fields are replaced by SNA manager control fields (see Figure 



V.._..,./ 



■ 32 (dec) bytes 



-H 



000 



040 



; p p 

Task Management Fields 



Task Register Save Area 



[W i i iinuM ii 



Replaced by ^ ^ ^^ 

• Command Processor Control Fields, or^ 

• BSC Line Manager Control Fields, or 

• SNA Manager Control Fields 



Tililt iMilillll 



iitillt iTiMiUlM 



Figure 5. 9, Task Control Block (Part 2 of 2) 



How to Locate 



Refer to Figure 6.1 in Section 6. 



\._. 
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c 



c 



^bito>;^'' 



TCB - XASK MANAGEMENT FIELDS 

Storage Descriptor 
^ /s ^ 



TCBI 


TCTI TCCU TCRI 


TCTP 


TCTN 


TCPF 


TCSF 


TCCT 


(Task class list) 

1 1 










CE 


TCMW 


TCAW 



X'FF' = Delimiter for TCCT '■ 

It can be in byte 1 of any of the four fullwords 
allocated to TCCT depending on the number of 
entries (maximum = 4) in the task class list. 



-TCFT 
-TCJB 



Bytes in TCB 



Dec 



Hex 



00-03 
Oa-07 



00-03 
04-07 



H 



Label of| 

field I Description/function of Task management fieldis 

(Note ^) I 

X- ^ 

TCSD or 

ITSD or 

OGSD or The first 16 bytes contain the storage descriptor 

TNSD or 

TPSD or 

TCBSD 



-~^ 



TCBI 
TCTI 



h 



Storage descriptor block ID (TCB) 
Task ID 



TCB belongs to a command processor task. 
Remaining 3 bytes are 'bCP* 

TCB belongs to an initiator/termiinator 
task. Remaining 3 bytes are 'blT* 



X«D6' (O) 
X'C9' (I) 
X'E3' (T) 



yD9' (R) 
X'E6« (W) 
X'CS' (E) 



XT1'-*F9« 
(1-9) 



X'D3D9D3DU' 
CLRLM*) 



X'D7U0D7E2* 
CPbPS') 



H 



X'40C1C3E3 
( • bACT • ) 

X'Dir (J) 



TCB belongs to the terminator task. 
Remaining 3 bytes are 'bTT* 



-H 



TCB belongs to a local reader, 
TCB belongs to a local writer. 



"H 



- — ^ 

TCB belongs to an execution processor task. 
In this case the next byte contains X* 40*^ 
and the remaining bytes in the field 
indicate the partition that requested the 
task. For example, X'C6F1' = foreground 1 
partition. 

TCB belongs to _an RJE task. In this case 
the three remaining bytes will indicate the 
type of task. (RDR, LST, PUN, LGN, LGF, or 
MSG.) 

H 



TCB belongs to a line manager task. 
TCB belongs to a status task. 



TCB belongs to an account task. 



-H 



-H 



TCB belongs to a spool management task, the 
three remaining bytes indicating the type 
of task (RDR, LST, or SPM) . 



Figure 5.10. Task Management Fields (Part 1 of 6) 
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16-19 



Bytes in TCB 



"T 



Dec 



H 



Hex 
08-11 108-OB 



12-15 



OC-OF 



TCCU 



+ ' 

TCRI 



10-13 



TCTP 



—+- ---+—- 



Label of 
field 



Description/function of Task Management fields 



Physical device ID 

Physical unit address. If byte of the task ID field 
X'Fl' - X*F9' (1-9), then TCCU contains the RJE line 
number, or 'SNA* for all RJE,SNA TCBs. 



•PSP' (for RDR task) and rGSP* (for LST task) are used 
respectively for PUTSPOOL and GETSPOOL/CTLSPOOL 
processing. 

Terminal ID 



The following two fields form part of the task selection 
list (TSL). Task selection list is described in Section 
(see also Appendix D) . 

Address of task control block belonging to previous task 
in task selection list- 



-H 



^^^^ 



Byte = ID in binary format 

Byte 1 = ID in character decimal format 

Identifies the terminal ID requiring the task. If TCRI = 
binary i.eros (0000) , then task started as result of 
command invoked by the central operator. 



-i 



-^ 



20-23 



14-17 



TCTN 



h 



-™-+ 



Address of task control block belonging to the next task 
in task selection list. If the present is the last task 
control block in the chain, the address in TCTN is that of 
the wait control block. 



H 



24-27 



18-lB 



TCPF 



28-31 



IC-IF 



TCSF 



Page fault request word. Contains page fault request 
information resulting from a page fault interrupt • 
Contents of GPR 13, passed from DOS/VS supervisor and 
saved for page management in the event of a page fault 
occurring during execution of the task- The field is set 
to binary zeros when no page fault request condition is 
present; hence, it will contain binary zeros during the 
time that the task is in control of the central processor. 



Task selection field. 

Byte (the first byte in the field) = Task State Value 



-^ 



appendage routine. 



Task State Values 

At any time, each task within the POWER/VS must be in one 
or another of a set of task states. The state of each 
task is defined by the single alphameric character in byte 
28 of the associated task control block,, and this in turn 
determines what action the task management routines must 
take when the task is examined for dispatch. 

Task states are normally set by the task itself whenever 
one of the task management macros is issued. The task 
management routines,, the command processing task and the 
execution reader tasks are privileged, however, in that 
they may modify the task state of tasks other than 
themselves. 

Note: Task states can also be set by the page fault 



— J 



Figure 5.10. Task Management Fields (Part 2 of 6) 
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c 



Bytes in TCB 



H 



Dec 



Hex 



Label of 
field 
(Note ^) 



Description-function of Task Management fields 






Task states 



Not 
dispatchable 



Conditionally 
dispatchable 



I Immediately | C 4 
dispatchable 
|. „+ + 

Running |D9 | R 



Hex 



C9 

D7 
D6 



D3 

C6 
DU 

D8 

C3 

E2 



Char 



I 
P 
O 



F 
M 

Q 
C 
S 



^ or for an RJE task, 
posting. 



Task condition 



Task is inactive 
Page fault in process 
Waiting for operator 
response 



I Label 

I or 

I Routine 



Waiting for locked 

resource 

Waiting for the LTA 

Wait on multiple CCB or 

ECB posting ^ 

As for M state , except 

event may never occur 

Wait on single CCB or 

ECB posting ^ 

As for C state, except 

event may never occur 



Dispatch task 
immediately 

Task is running 



+ 



TMIO 
TMIO 
TMIO 



TM30 

TM55 
TM50 



TM80 



waiting for a single ECB 



TM90 

Not 
appl . 

^ 



^ or for an RJE task, waiting for a multiple ECB 
posting. 



J 



Bytes 1-3 = Address of the routine in the nucleus that 

tests for the condition indicated by the task 
state. 



Figure 5.10. Task Management Fields (Part 3 of 6) 
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Bytes in TCB 



Dec 



Hex 



32-48 



U3 



44-47 



2 0-30 



23 



2C-2F 



T^ f 

Label of 
field 



H 






TCCT 



Descrirtion/f unction of Task Management fields 



Task class list (plus a 1-byte field of X'FF') 
Up to four different classes can be specified 
simultaneously for any task, except RDR task. For each 
class identifying character an entry is made in the TCCT 
field in the TCB for that task. The first byte of each 
entry contains the class, and the remaining three bytes 
contain an address of an ECB in the master class table 
area (in DMB) . 



FFOO 








FF 












FF 




, Pointed to by R1 in the TRSA 
if tasl< is in C state. 



(forms'an ECB address list pointed to by R1 
in TRSA when task is in M state) 




4 entries in a TCB for a LST task 
I 



Master Class Table Area _ 
(See Figure 5.8) 



C3 



inMCTA 



C2 
I 



n^ 


■7~:7~~c^ 






-y 


I Entries for RDR tasks 


> 


_. 




Class B 






^" 1 »^iass M 


^ Class C 


Class D 


Class E 


Entries for LST tasks 


^ 










1 Class Y 


Class Z 


Z*' 






FntrioQ fnr PUM ta<!!<:«; 




y 



s. 



Fields used by Spool Management Task 



-^ 



TCSS I Spool Management Switch 

TCIW jc'l' - Logical writer already initialized 

TCOW I CO '--Open Logical Writer 

TCCW |C'C'-Close Logical Writer 

TCER [Address of user's cross-partition XECB 

i 



J 



Figure 5.10. Task Management Fields (Part 4 of 6) 
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Bytes in TCB 
Dec I Hex 
49 131 



50 



51 



( 



32 



+ 

33 



Label of 
field 

TCTT 



+ 

TCFT 



h 

TCJB 






Description/function of Task Management fields 
Termination type 



-H 



I Hex jcharj 



— ^ 



40 I (b) [Normal - continue execution 
E4 I (U) I Unrecoverable I/O error 
E7 I (X) I TASK cancel condition 
C3 I (C) IPCANCEL command issued 
C6 I (F) IPFLUSH command issued 
C5 I (E) I Stop at end of job 
E2 I (S) [Stop immediately 
C8 I (H) IPFLUSH with hold issued 
D9 I (R) I Stop immediately and restart 
-, X X 



Job boundary switch 

FF = Start of job 
00 = Job boundary 
80 = No job started yet 






Function track indicator. 

This indicator is used by the task terminator phase (TR) 
to determine the appropriate action in case of an I/O 
error on the queue file or the data file. The following 
entries are possible: 



-H 



On input 



X'D5* 


N ' 


X'C9* 


I 


X'C7' 


G 


X*C4« 


D - 


X«C3' 


C 


X*C6' 


F - 


X'C5« 


E 


X'D3« 


L - 


X*00* 





or 




X'40' 


b 


On output 



X- 



X*D9* 
X'D6' 
X'D7« 
X'Cl' 
X'C5» 
X'D3" 
X'OO* 
or 

X*40* 
X 



R 
O 
P 
A 
E 
L 




- Get next from queue 

- Open for input 

- Get in process 

- Delete in process 

- Free pending 

- Free in process 

- End of queue action, awaiting accounting action 

- Put account record in process 

- No entry active 

- No entry active 



Reserve queue in process 

Open for output 

Put in process 

Add to queue 

End of queue action, awaiting accounting action 

Put account record in process 

No entry active 



No entry active 



Figure 5.10. Task Management Fields (Part 5 of 6) 
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I- 



h 



h 



Bytes in TCB 

^ , 



Dec 



52-55 



52 



53 
54 

55 



56-59 



h 



60-63 



^ ^ . 

Label of I 
-^ field I Description/ function of Task Management fields 



Hex 



3a- 37 



34 



+- 



35 
36 
37 



38- 3B 



3C-3F 



TCEB Task event control block (see Appendix D) 



TCDB I Double buffering indicator 
TCB2 |C'2* - two buffers in use flag 



TCCB I Function communication byte 

TCAS lx'40' -- asynchronous service user 

TCEP I Event post byte 

TCEP 'x'BO' - event post bit on setting 

I Reserved 
1 



Each POWER/VS task tnat needs to perform input or output operations 
addressed to the system console must specify the operation required 
in the form of a message request word or a reply request word. 
These control fields are used to pass the necessary parameters for 
the operation of the message service routines. 



TCMW 



TCAW 



Message request word (see note ^ for message formats), 



H 





1° 


'1= 




H 












Hold flag 
and R5 flap 


Message Address 





The message address field contains the virtual address of 
the message control byte, that is, the byte that 
immediately precedes the text of the message to be output. 



Reply request word (see note ^ for message formats). 



7 8 



31 



Binary 



Reply Address 



The reply address field contains the virtual address of 
the reply control byte, that is, the byte that immediately 
precedes the input area into which the reply is to be 
read. 

If no reply is to be made to the message, this field must 
contain binary zeros. 



'v„ y 



Figure 5.10. Task Management Fields (Part 6 of 6) 

How to Locate 

Refer to Figue 6.1 in Section 6. 
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( 



TCB - TASK REGISTER SAVE AREA (TRSA) 

The fields in this area in a TCB record the contents of registers 12 through 9 whenever 
entry is made to task selection. If the task state is set to R (running) the values in 
the fields record the contents of the registers when the task was most recently given 
control. If the task state is set to any other value the fields contain the current 
contents of the registers associated with the task. 



_32 bytes . 



Format of a TCB as printed 
in a dump 







































TCRC 


TCRD 


TCRE 


TCRF 


TCRO 


TCR1 


TCR2 


TCR3 




TCR4 


TCR5 TCR6 TCR7 


TCR8 


TCR9 


Restart 
information 








save area 
for service 
routines 


Reserved 










1 


































































BCW 





TRSA 



paclced device 
address 

account trace 
indicator 
device type code 



C 



TCTR or 
TNTR or 
ITTR or 
OCTR^ or 
TPTR or 
TCBTR 



Bytes in TCB 

T 

Dec [ Hex 
+ 



H 



64-67 



68-71 



U0-U3 






414-47 



Label of I 
field I 
(Note ^) I 



Description/f uhct:4on of fields in TRSA 



-^ 



-^ 



TCRC i Register 12 - asynchronous address register ('task PSW') 

I 

[Register 12 contains the address of the first instruction 

I to be executed when the task is despatched. The first 

I byte contains the condition code and the program mask bits 

I in the form in which they are loaded by BAL instructions. 

I (This is also true when the information is provided by the 

I page fault appendage routines.) 



TCRD I Register 13 - save area register 

I 

I Register 13 may contain the address of either the first 
I (or only) or second linkage register save area depending 
Ion the hierarchy level of the caller. 

X .- 



Figure 5.11. Task Register Save area (Part 1 of 3) 
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Bytes in TCB 
Dec I Hex 
72-75 U8-UB 



76-79 



80-83 



84-87 



88-91 



ac-UF 



50-53 



— + 



54-57 



58-5B 



Label of 
field 



TCRE 



+ 

TCRF 



TCRO 



+ 

TCRl 



Register 15 - entry point register 

Register 15 is used to address the entry point of the 
routine to be entered when an entry linkage is performed. 
This address is normally that of the storage descriptor 
which precedes the routine to be executed. The register 
may be conveniently used as the base register for the 
function to be executed. When not required for this 
purpose the register is available for general use. 
+ 



TCR2 



Description/function of fields in TRSA 



Register 14 - linkage register 



Register 14 is used to contain the linkage address,, that 
is, the address to which return is to be made when an exit 
linkage is next performed. When not required for this 
purpose the register is available for general use. 



H 



Register - parameter and work register 

Register is used to pass parameters to and from invoked 
routines. When not required for this purpose the register 
is available for general use. 

. H 

Register 1 - parameter and work register 

Register 1 may address a control block or control block 
list on which the task is at present waiting. For a task 
in C or S state it will point to a conventional DOS/VS CCB 
or a POWER/VS ECB. For a task in M or Q state, it will 
point to an ECB or CCB list. (Refer to Appendix D.) 

Register 2 - linkage and work register 

Register 2 is u6ed by service routines to retain the 
return address of the requesting task. It also has 
machine usage when a translate and test instruction is 
executed. When not required for these purposes the 
register is available for general task use. 



-H 



92-95 



5B-5F 



TCR3 






96-99 

h 

100-103 



104-107 



L 



60-63 



+ 

TCR4 



+. 



64-67 



TCR5 



Register 3 - resource address register 

Register 3 may contain the address of a resource control 
block on which the task is at present waiting (task in L 
state). When not required for this purpose the register 
is available for general task use. 

Register 4 - work register 



f~- 

68-68 



TCR6 



Register 5 - work register 

If the task owns queue space, this register will address 
the queue record. 



Work register (may address the DMB) . 

In an execution processor task, it addresses the partition 
control block. 



Figure 5.11. Task Register Save area (Part 2 of 3) 



V. 
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h 






116-119 
f 

120-123 



Bytes in TCB 



Dec I Hex 



108-111 I6C-6F 



+- 



112-115 



+ + 



+ 



h 



124 
125 



126-127 
128-131 
132-135 
136-139 

140-143 



70-73 



TCR7 



+ 

TCR8 



78-7B 



TCR9 
+ 

TCRS 



TCRX 






7C 

7D 






7E-7F 

80-83 
84-87 
88-8B 
8C-8F 



Label of 
field 



TCRP 



+ 



TCDT 

+~ 

TCAT 



+ 

TCDE 
TCRG 

TCRH 
TC3E 
TCPL 



Description/function of fields in TRSA 



^ 

Work register. 

In an execution processor task this register addresses the 

user CCB. 

Work register. 

In an execution processor task this register addresses 
current channel command. In a physical routine, it points 
to PWS. 

^ 



Base register for highest level of code used by task. 

Restart information 

This field contains an action type code in byte and a 

value in bytes 1-3, as follows: 

byte 0: (restart function index) 

X"04' restart at specified record (card or page) * 
X*08' skip forward specified number of records * 
X'OC skip back specified number of records * 

( * set by PRESTART command) 
X'lO* print specified number of pages (set by PSETUP 

command) 
X'14' restart at specified record (card or page) (set by 

PSTOP with RESTART option) 

bytes 1-3: (restart page count) 

The number of records (cards or pages) to be acted upon. 



Device type code of device in TCCU field 

Account trace indicator: 

This indicator is used by the task terminator phase (TR) 
to determine the appropriate action in case of an I/O 
error on the account file. 

It can contain the following: 



O 
A 
G 
C 

¥ 
E 




Open for reading account file 

Caller active 

Get in process 

Close in process 

Keep account file in process 

Erase account file in process 

No entry active 



X'D6* 

X'Cl' 

X'C7* 

X'C3* 

X'D2» 

X*C5« 

X'OO' 

or 

X'40* 

Packed device address (of TCCU field) 
Save area for service routines 

Save area for service routine 
Address of TCB extension area 
Address of Spool parameter list 



b - no entry active 



Figure 5.11. Task Register Save area (Part 3 of 3) 



How to Locate 



Refer to Figure 6.1 in Section 6. 
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TCB ~ GENERAL TASK WORK AREA, LINKAGE REGISTER SAVE AREA, AND FILE CONTROL WORDS 

When the TCB belongs to a comrrard processor task, this part of the TCB is replaced by 
command processor control fields (see Figure 5.13)-, when it belongs to a BSC line manager 
task, it is replaced by BSC line manager control fields (see Figure 5.34),, and v^hen it 
belongs to an SNA manager task,, it is replaced by SNA manager control fields (see Figure 
5.a0), 



■ 32 (tied bytes - 



X_,,...^ 







General Task Work 


Area 






Linkage Register Save Area 




Data File Control Worcis 


Blocking Control Words 


Record Control Wore) 


Queue File Control Words 





F- 



144-175 



Bytes in TCB 

nex 
AF 



Dec 



! 



144-159 

160-163 
164-167 
168-171 
172-175 

160-167 
168-171 
172 



h 



144-147 
148 
149 
150 

151 

152-155 

156 

156-159 

160-167 

168-170 

171 

172-175 



9 0-? 



9 0-9F 



AO- 

A4- 
A8- 
AC- 

AO- 

A8- 
AC 



■A3 
■A7 
'AB 
AF 

■A7 

•AB 



T 

; Labf^l 

^ field 

(Note 



r- 

ofl 



f- 



90- 
94 
95 
96 

97 

98- 

9C 

9C- 

AO- 

A8- 

AB 

AC- 



93 



•9B 

■9F 
■A7 
•AA 

•AF 



^)1 



j Description/Function of Fields 



^ „^ ^ 

General Task Work Area 

j This area may be broken into fields in whatever way is 
I required by a task (for example,, logical reader and writer 
]work areas). It can also contain the 3540 communication 
jbyte (LWER) : 

|X'01* = card reader with a 3540 attached 
1X'02' = reading from 3540 
1X'04' = 3540 data file processing 
TCGW lUsed by logical routines 



TCWl 
TCW2 
TCW3 

TC':v4 

TCJN 
TCXA 
TCSW 



|. ^„. 

I Used by SNA routines as SUCB pointer 

1 Used by SNA routines as work area pointer 

jused by SNA routines as save area for register 13 

I 



H 



] spool management job name 

[Address of error exit return in IPW$$SM 

I Switch byte 



-^ 



I Redefinition of the General Work Area Used by the 
I Logical Writer 



-H 



LWFI 
LWNC 
PPEB 
LWEJ 

LWFT 

LWAW 
LWLC 
LWAD 
LWFB 

LWPS 
LWFH 



Current forms identifier 

Current copy/transmission count 

Empty block indication 

Restart switch 

X'80' restart at EOJ time 

Separator page flag 

C'1' - separator pages indicator 

Address account counter workspace 

Last command code 

Address of buffer for separator pages 

Current FCB name 

Unused 

Current paper threading (3800 only) 

Current flush identifier (3800 only) 



jTCSV 



[Linkage Register Save Area (LRSA) 

>JL . : 



._.. J . 



I 



Figurei 5.12. 



General Task Work Area^ Linkage Register Save Area and File Control Woras 
(Part 1 of 3) 



^^\,. .J" 



(f 
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1 Byte 


s in TCB 


1 Label 


Of 1 ! 






-4 f iel d 


1 Description/function of fields | 
^) 1 1 

._ ^ _ _ _ _ ^^ ^-.^•-^ ^ ^^« — , ^^ii 


1 Dec 

1- 

1176-179 


~T — '^ 

1 Hex 

-+ 

IB0-B3 


1 (Note 

-+ 

1 SVTC* 


JTask control block address j 


1 180-183 


IB4-B7 


J SVSV** 


1 Pre^rious save area address points to second of double LRSAJ 


1184-187 


|B8-BB 


1 SVRE^ 


[Saved register 14 1 


1188-191 


1 BC-BF 


|SVRF^ 


1 Saved register 15 | 


1192-195 


|C0-C3 


|SVRO^ 


1 Saved register j 


1196-199 


IC4-C7 


1 SVRl ^ 


j Saved regirter 1 j 


1200-203 


IC8-CB 


1 SVR2^ 


1 Saved register 2 ! 


1204-207 


ICC-CF 


1 SVIJ3^ 


1 Saved register 3 | 


1208-211 


ID0-D3 


|SVR4^ 


J Saved register 4 | 


1 212-215 


ID4-D7 


|SVR5^ 


1 Saved register 5 j 


1216-219 


ID8-DB 


ISVR6'* 


1 Saved register 6 1 


1 220-223 


IDC-DF 


|SVR7^ 


1 Saved regi-ster 7 | 


1224-227 


IE0-E3 


|SVR8^ 


1 Saved register 8 j 


1 228-231 

L 

1 


IE4-E7 

-+ 

1 


1 SVR9^ 


] Saved register 9 | 


1 


I Data File Control Words j 


1 




_ 1 ._^_ 




r 


— -^—— .———.— ^-. 






1 232-239 

1 

1 

1 

1 

1 

1 


IE8-EF 

1 

1 

1 

1 

1 

1 

1 


ITCDW 
1 

1 
1 

1 
1 
1 
1 


|Data file seek address (MEBCCHHR) M = index into the ] 
1 module load address table. ] 

1 For tape spooling, this 8 byte field is defined as ] 
1 follows: 1 

1 Bytes I 


1 


1 Tape flag (X'80') | 


1 


1 


1 


! 1 Reserved | 


1 


1 


1 


1 2-3 Length field j 


1 

j 


1 
1 


1 
1 


1 4-7 Address of tape control block | 


1240-243 


1 

JFO-FJ 


1 

j TCDA 


|Real data area address (see Note 3) j 


1 244-247 


IF4-F7 


|TCDV 


(Virtual data area address j 


[. 


_^ 


-+ 


-j. , — j| 


1 

|. 

1248-251 


1 
-+ 

IF8-FB 


1 

-+ 

ITCBC 


1 Blocking Control Words \ 


1 Residual block count 1 


1252-255 


1 FC-FF 


ITCPR 


[Previous record address J 


F ^ 


-+ 


-+ 




J I I 1. J I II ■ ■ ■mmm^ *>- ■» 4J 


1 


1 


JTCRW 


1 Record Control Word (formed from CCW) j 


1- 


-+ 


-+ 


j. ^ 


|256 


|100 


ITCCC 


1 Record command code j 


1 257-259 


1101-103 


ITCRV 


1 Record address (virtual) I 


|260 

1 

1 

1 

1 

1 

1 

1 

j 


|104 

1 

1 

1 

1 

1 

1 

1 

1 


|TCGP 

1 

1 

1 

1 

1 

1 

1 

1 


1 General purpose byte (see Note 5) ] 

jx'OO' = normal recora j 
1X'02' = 3540 data record | 
|X'04' = end of data j 
fx'08' = break record j 
jx'lO" = end of block J 
IX' 20' = end of 3540 data j 


|261 

1 
1 


|105 

1 

1 


1 

1 TCG2 

1 
1 


j General purpose byte j 
|X"01' = TCB for read only operations j 
|X'08" = device end occurred (reader) j 


1262-263 


1106-107 


JTCRL 


[Record length j 



I 



I 

-X- 



i 
—J 



JI/O (disk or tape) Request Word for Queue File 



Figure 5.12- General Task Work Area,, Linkage Register Save Area and File Control Words 
(Part 2 of 3) 
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Bytes in TCB 

I ■ r - 

Dec I Hex 
h- - -.- H~~ -~ 
264-271 1108-lOF 



-i- 



27 2-27 5 
276-279 



110-113 
114-117 



Label of 

field 

(Note!) 



-~f~- 



TCQW 



TCQA 
TCQV 



Description/function of fields 



Queue file seek address (MBBCCHHR) M = X'04' 

For tape spooling this 8 byte field is defined as follows j 

Bytes 

Tape flag 

1 Reserved 
2-3 Length field 

4-7 Address of tape control block 

Real queue space address (see Note 3) 
virtual queue space address 

4 . : 



Data File Control Words for 2nd Buffer (Note: 6) 



This extension of the TCB exists only when a list task 
has been started with 2 data file buffers. 



280-287 



288-29 
292-29 
296-31 



118-11F 

120-123 
124-127 
128-137 



TC2DW 

TC2DA 
TC2DV 

TC2LN 



Data file seek address for 2nd buffer (MBBCCHHR) . M 

index into the module load address table. 

Real data area address (see Note 3) 

Virtual data area address 

Reserved for future use 

Length of extended control block 



Figure 5.12. General Task Work Area, Linkage Register Save Area and File Control Words 
(Part 3 of 3) 



How to Locate 



Refer to Figure 6.1 in Section 6. 
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Note ^ . The first characters of the labels in the control block vary according to the 
generated DSECT or declaration (PL/S). 

• TC = Current TCB 

• IT = Initiator/ terminator TCB (used within the CSECT of NU),. 

• DC = Operator command processor (used within the CSECT of NU). 

• TN = Used to address a "TCB other than the task's own TCB. (To enable a task to 

address the TCB of anc^ther task.) 

• TP = Used to address a TCB other than the task's own TCB. (To enable a task to 

address the TCB of another task. ) 

• TCB= Used to address a TCB other than the task's own TCB in the PL/S listings. 

Note ^ . Message formats 

1 73 (max.) 



- Maximum of 72 characters 



t: 



Length of message field in bytes 



The message field may contain variables for which the message modification routine in the 
message module (IPW$$MS) will substitute the appropriate fields. 

Note ^ . The high-order byte of this field will contain the command code of the current 
or last executed operation. 

Note ^ . These labels refer to fields in a second LRSA described in Figure 5.1U. The 
second LRSA has a format identical to that of the LRSA in the TCB. 

Note ^ . Bit 7 of this byte may be set to (to indicate no data transfer or card 
motion), or to 1 (to indicate data transfer or card motion). 

Note^ ■ The command processor has acquired a larger storage area for the extended TCB. 
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( 



COMMAND PROCESSOR CONTROL BLOCK (CPB) 



This block replaces part of a command processor TCB, when a command is entered via the 
console keyboard by the central operator, and of its associated temporary command 
processor TCB when linkage is made via the IPW$ICP macro. 



TCB 
forCP 



^ 














. 1 








, ^1 














































CPB 





see Figure 5^ 



CPB replaces file control fields, general task work area,, and LRSA of standard TCB, 
The contents of the CPB, in both cases, are described below: 



-^ , — _^ 

I I 

-^ Label of | Description/function of field 
I field I 



C 



I 

I— 
I 00-- 
|16 
|17- 
|2U- 
I 96- 
I 104 
I 108 



Bytes 



Dec 



I 



Hex 



15 |00~0F JCPSD (storage descriptor (CPB) 

jlO |CPID jRJE-userid (0 for local) 

23 I 11-17 |CPCM I Command code 

95 I18-5F |CPOP JOperands (free format) 

103 I 60-67 |CPNO j Sequence number (RJE only) 

-107 |68-6B jCPEA [Address of caller ECB 

-135 |6C-87 I j Reserved 



-H 



Figure 5.13. Command Processor Control Block 



How to Locate 



Refer to Figure 6.1 in Section 6,. 



SECOND LRSA 



Included by definition macro IPW$DSA for the save area. 

A second LRSA is required by some tasks to link routines within the tasks. This second 
LRSA has the same format as the LRSA described in the TCB (see Figure 5.12). 



RELATIONSHIP BETWEEN LRSAS 






L inkage from a Physical Routine to a Logical Routine 

Execution of the IPW$OLI macro instruction causes the creation of a second LRSA. The 
first LRSA is associated with the physical routine issuing the macro instruction 
(physical save), and the second LRSA is associated with the logical routine invoked by 
the macro instruction (logical save). Th^ first fullword of each save area is 
initialized to address the TCB of the issuing task. The second fullword of each save 
area is initialized to address the other save area. The address of the internal routine 
entry point is stored in the third word of the internal routine save area. 
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The first and second LRSAs are collectively called a double linkage register save 
area (DLRSA) • Linkage between the first and second LRSA in a DLRSA is shown in Figure 
5.ia, parts 1 and 2." Refer to DOS/VS POWER/VS Logic Part 2 (phases IPW$$PR, IPW$$PL, 
IPW$$PP) for the contents of the registers in the first LRSA. 



V...>^ 



Double Linkage Register _ Save Area (DLR SA) 



Case 1 - where task is executing code in the physical routines (PR, PL, PP) 

R13 

Rl3lnTRSA flttLRSA 

TRSA 

1st LRSA (for Physical rtns.) 




always 



>- 1st LRSA 


f^ 


■-• 


14 


15 





1 


2 13 


1 4 


-5. 


-L. 


7.. 


.8 


-9- 


BCWJ 



1} 



2nd LRSA (for Logical rtns.) 



Figure 5.14. Part 1: Linkage between the two LRSAs in a Double Linkage Register Save 

Area (case 1) 

Ca se 2 - where the task is executing code in the logical routines (LR, LW) . 



\_/ 



R13inTRSA t 2nd LRSA 




always valid 



> ■ 1st LRSA 


u 


^ 


14 


15 





1 


2 13 


ll 


5_ 


6, 


7_ 


8. 


9- 


BCW 1 



LRSA (for Physical rtns.l 



^2nd LRSA (for Logical rtns.) 



TCB 



Figure 5.14. Part 2: Linkage between the two LRSAs in a Double Linkage Register Save 

Area (case 2) 

Execution of the IPW$CLI macro instruction causes destruction of the interface linkage 
previously established by the IPW$OLI macro instruction and release of the second LRSA 
acquired by that instruction. Once the IPW$CLI macro instruction has been issued no 
further IPW$GLR or IPW$PLR macro instructions may be issued until the next IPW$OLI macro 
instruction is issued. 



Linkage from a Logical Routine to a Function 

Each POWER/VS function is coded as a unique control section. The first sixteen bytes of 
each control section consist of an alphameric control section descriptor. A fullword 
address constant containing the address of each control section is contained in the 
control address table. 



V 
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Linkage to a function is achieved by loading register 15 with the address of the 
appropriate control section and then executing a Branch and Link instruction in the form 
BAL 1^^,16(15). Thus, entry is made to the control section at the first byte following 
the control section descriptor, the task return address being preserved in register lU. 



Immediately upon entry the contents of registers 14 through 9 are saved in words 3 
through lU of the LRSA provided by the calling routine and addressed by register 13. 

On return from a function, registers 14 through 9 are restored from the LRSA 

addressed by register 13. A branch is then made to the return address now contained in 

register 14. Refer to DOS/VS POWER/VS Logic Part 2 phases IP*^$$LR and IPW$$LW for the 
contents of the registers in the second LRSA. 



Linkage to a Function __from an Execution Processor Routine 

The LRSA of the TCB is also required by execution processors (XR, XW) in order to save 
the registers if the execution processor routine needs a function. Refer to Section 3 
phases XR, XW descriptions for the contents of the first LRSA. 



t to start of the TGB for this LRSA 



c 



Format of a TCB as 
printed in a dump 




Figure 5.14, 



TRSA 



contains binary zeros 
LRSA for registers used 
the execution processor 



. register 13 in TRSA f the LRSA 

Part 3: Linkage from an Execution Processor XR/XW routine 



A different situation is when an execution processor task is executing code in XJ. In 
this case, a second LRSA is required as shown below: 



register 13 in TRSA 



t to TCB that 
owns this LRSA 




LRSA to save the registers 
the XR routine 



LRSA to save the registers 
the X J routine 



Figure 5.14. Part 4: Linkage from an XJ JECL Analysis routine 



c 



Refer to DOS/VS POWER/VS Logic Part 2 (phase XJ description) for the contents of the 
registers in the second LRSA. 
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Linkage to a Servic e ^ ,^ 

No registers are saved^ other than in the TCB, when going from an '"K^:.._.J^ 

• external routine to a service/, or from an 

• internal routine to a service,, or from a 

• function to a service-, except in the case Of calling storage management, when 
registers 14 through 5 are stored in the SCB ( see Figure 5»6)/ and in the case of 
calling message service when legistei 5 is stored in the MMB. 

Note: Any service may use registers through 3 destructively, (consult comments in 
program listings and/or the descriptions in DOS/VS POWER/VS Logic Part 2 for the service 
entered.) 
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( 



( 





IPW$$CP 
Command Processor 


















An LRSA 
outside TCB 






















\ ' 




w 






Physical Routines 




Execution processor routines 












\ 


f 














Save regis 
by physic 
in first LF 








ters used 
ail routines 
SA inTCB 








' 


' 










Logical Routines 














1 


f 


















Save regis 
by logical 
in second 
outside T 






"ill 
1 Mi 




1 
















r 




Save registers used 
by execution pro- 
cessors in LRSA 
in TCB 


*■ 






Functions 










1 












' 










No save area 
linkage is via 
BALR instruction 
















' 


f 








Services 





Figure 5.14. Part 5: Summary of Linkage Register Save areas 
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PHYSICAL WORK SPACE (PWS) 



Definition macro: IPW$DPW 

The physical work space is used to address and save the information necessary for 
reentrance of the physical reader/v^riter. The area for PWS is reserved by the physical 
routine. It records information that points to a physical data area. 

The relationship between the PWS and the PDA is illustrated in Figure 5.48- 

Note: There is no PWS for an RJE task; it is replaced by information contained in the 
BCA (see Figure 5.33). 



'V ^ 



h- 



h 



h 



Bytes 



Dec 



Hex 



-T T ■ 

I 

-^ Label I Description/function of field 
of field! 



00-03 



00-03 



04-07 



104-07 



08-11 



108-OB 



12-15 



lOC-OF 



16-19 



110-13 



20-23 



24-25 



+. 



114-17 



118-19 



26-27 



IIA-IB 
I 



28-31 

28 

29 
30-31 

32-35 

36-39 

F 

40-43 



IIC-IP 

I IC 

! 

I ID 

I lE-lF 

•+ 

120-23 

•f 

124-27 



I2 8-2C 



44 

45 

46-53 

54-55 



I2C 
I 

I 2D 

|2E- 

135- 



34 
37 



PBVl ivirtual address of the first PDA 
+ « 

PBRl I Real address of the first PDA 



PBV2 i Virtual address of the second PDA 
+ « 

PBR2 I Real address of the second PDA 



PWVE ivirtual address of the active PDA 
+ 

PWRE jReal address of the active PDA 



PWLC ] Displacement of last CCW in string from beginning of PDA 
+ . . .^ ^„ 

PWRL I Physical record length: to update the record pointer in 
] the deblock routine 



PWDI 
PWDB 

PWDT 

PWLU 

+ +- 



PWDV 

PWDA 






PWCA 



] Device type information 

1 1 byte = single/double buffering (contains number of 

i buffers) 

jl byt€ = device type of unit record device 

I 2 bytes = LUB number 



ivirtual address of end of PDA 

jReal address of end of PDA 

+ ^^.„< 

[Real address of the first CCW 



PWOT 'Operation byte 

PWT;vC IX' 80' wait for completion request 

PWME iMessage reply length 

PWRA [Message reply area 

iReserved for future use 



^ 



'\,.„ y 



Figure 5.15. Physical Work Space (Part 1 of 2) 
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( 



( 



r 




"T T - ~ -" • 




[Bytes 

L^«^ ^^ 




1 1 


Description/function of field 




|._ J. 


^ i-lCXkJ^ ±. ] 




1 Dec 


Her 


|of fieldl 

J J 






L«^^^«. J 





1 1 

J 1 


3540 Extension 


"" "' 


Y ^ 


""*""""" "" " '"■"■ 


— ^ j 


r "" — -» 




1 156-57 


38-3B 


JPERA 1 
1 PEDI 


Real address of the physical work space. 
Device type indication. 




|60 


3C 


1 


Reserved. 




|61 


3D 


1 PEDT 


Device type. 




162-63 


3E-3F 


! PELU 1 
1 PEDP 


Programmer logical unit. 
Diskette parameters from PSTART. 




1 164-71 


40-47 


|PEFI 
IPEPS 


File identification-. 
PSTART parameters. 




|72 


48 


1 1 


Reserved. 




|73 


49 


IPEND 


Number of diskettes to be read. 




174 


4A 


JPESC 


Sequence check required. 




|75 


4B 


IPEVE 


Verify requested. 




176-79 


4C-4F 


IPECD 


Displacement between real and virtual CCB addresses. 




180-83 


50-53 


IPECV 


Address of 3540 CCB or physical data area. 




184-87 


54-57 


1 PEDV 


Virtual address of first 3540 data buffer. 




188-91 


58-5B 


1 PEDA 


Real address of first 3540 data buffer. 




192-95 


5C-5F 


1 PEVN 


Virtual address of second data buffer. 




196-99 


60-63 


jPERN 


Rea."" addreuu of second data buffer. 




1100-103 


64-67 


i PEBS 


ReaJ. address of forced pre- SEEK CCW. 




1 104-107 


68-6B 


IPESK 


Seek address (OOCCHHRR) . 




1108-111 


6C-6F 


J PESO 


Overlap s-eek address (OOCCHHRR),. 




1112-115 


70-73 


IPELO 


Extent lower limit (OOCCHHRR). 




1116-119 


74-77 


|PEED 


Next sector address (OOCCHHRR). 




1 120-121 


78-79 


1 PERL 


Record length. 




1122-123 


7A-7B 


JPENN 
JPESI 


Number of buffers allocated in second data buffer. 
Sequence identification. 




1 124 


|7C 


1 PEMI 


Multivolume identification. 




1 125 


7D 


JPESN 


Volume sequence number. 




|126 


|7E 


1 PEOC 


Open return code. 




1 127 


7F 


1 PEOD 


Number of opened diskettes. 




1 128-135 


[80-87 


IPEDW 


Double word for conversion purposes. 




1 136-151 


88-97 


1 


Reserved. 





-H 



L J X X ^ J 



Figure 5.15. Physical Work Space (Part 2 of 2) 



How to Locate 



Refer to Figure 6.1 in Section 6,, 



PHYSICAL DATA RECORD AREA (PDA) 



Space for this area is reserved during the execution of a physical reader/writer routine^ 
The size of the area dependc on the specifications in the DBLK parameter. It consists of 
a CCB and a CCW string which constitutes the channel program, followed by 8 byte areas 
which contain the input or output data records. 

Note: For an RJE task the CCB and the channel program is in the BCA. 

During a read operation the area is initialized by calculating the amount of data records 
and their CCWs that will fit in the area. Then an SVC is issued to commence the I/O 
operation to read cards or 8 byte records into it. When it is fulL, the data is 
transferred to the logical data area by the function IPW$PLR and is ready for output to 
the spooling device assigned as the data file. Queue records are constructed on the 
queue file to record the seek addresses of the data on the data file. 
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During a write operation, the reverse occurs/ Data is read from the spooling device 
to the LDA from where it is transferred to this PDA ready for the physical routine to 
print or punch the data. 

Figure 5, 4 8 illustrates this relationship for an RJE task and for a local task. 

How t o Locate 

Refer to Figure 6.1 in Section 6. 

LOGICAL DATA RECORD AREA (LDA) 



This area is used to hold data which is to be written to the data file (read operation) 
and read from the data file (write operation) . its size is set by the DBLK parameter. 

Records are transferred to the LDA one at a time from the PDA for read and for write 
operations. When the LDA is full, or there is no more room for a complete record, the 
information is written to or read from the data file. It is addressed via the I/O 
request word in the TCB, and each record is addressed via the channel program in the MCB 
for the data file. Figure 5.48 illustrates this relationship. 

The format of a data record is shown below: 



■ \_ ./ 



RL 


GP 


CC 


« 

Text 

'. — ^l 



V 



Command code : Indicates command code for output list/punch device, or 
00 when input record or spooled account record. 



. General purpose byte 



' Record length 



00 = normal record 
02 = 3540 data record 
04 = end of data 



06 = break record 
10= end of block 
20= end of 3540 data 



Note: Bit 7 of this byte indicates card move/line print to be done 
2 bytes conteining the length of the logical record. 



Figure 5.16. Logical Data Record 

How to Locate 

Refer to Figure 6.1 in Section 6. 

MODULE CONTROL BLOCK (MCB) 

Definition macro: IPW$DMC 

Each module (an extent, always 1 for queue file and at least 1 for the data file) 
requires an MCB. The format and type of inforiration contained in any MCB is identical. 
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( 



The format of a module control block as it is printed in a dump is shown below: 

1*^ 32 (dec) bytes ►! 



00 
20 



60 



MCB 



Storage descriptor 

1 1_ 



Module Seek Address 



Reserved 



Lockword 



CCB (EXCP Real) 



Extent information 



Seek CCW 

1 



Sector or TIC CCW 

, 1 



Search CCW 



TIC CCW 

1 

MCNR MCNT 



Read or Write CCW 



Reserved 



MC$T MC$1 

I 



AO 



Sector Table for SLI Support (optional) 



( 



j0im-._^ 



i Bytes 


1 


I 








L^^. — — 




_ J T ;:iKci1 


1 Description/function of field 








r — 


~T 






1 Dec 


1 Hex 


|of fieldl 








1 


1 


1 (Note 


^)| 










-+ 


«-^ — 


L ^ ^«.^-.«.^-.^ ^-,.^-.— .«.«-.„«,« 








J. «. ^«.^-.«.^— ^ ^-,. «,-.—.«.«-.„«,« 


" 


^ 




1 00-15 


1 00-OF 


IMCSD^ 


or [Storage descriptor MCB QFILEl 


cuu 


(SYSOOl) 




1 


1 


|D2SD^ 


[Storage descriptor MCB DFILE2 


cuu 


(SYS002) 




1 


1 


IMCSD^ 


[Storage descriptor MCB DFILE3 


cuu 


(SYS003) 




1 


! 


1 MCSD^ 


[Storage descriptor MCB DFILE4 


cuu 


(SYS004) 




1 


1 


IMCSD^ 


[Storage descriptor MCB DFILE5 


cuu 


(SYS005) 




1 


i 


IMCSD^ 


[Storage descriptor MCB DFILE6 


cuu 


(SYS006) 




1 


1 


IMCSD^ 


1 Storage descriptor MCB LFILE7 


cuu 


(SSL). 




1 


1 


|MCSD^ 


[ Storage descriptor MCB LFILE8 


cuu 


(PVTSSL) 




116-23 


110-17 


|MCSA 


[Modu2,e seek address (MBBCCHHRl 


2 






1 24-27 


118- IB 


1 


[ Reserved 








128-31 


ilC-lF 

^X— — 


IMCLK 


1 Lockword 








r *"*"*•*■"" "~~ 


T ~ — 


1 


1 * IU« 1 WJ •■ 


"" 


'" t m . . aj. OTi «> 


*" ■" 


1 


1 


IMCGB 
— ^ 


1 Command control block 








132-33 


120-21 


|MCCT 


1 Residual count 








1 34-35 


1 22-23 


jMCCM 


[Communication bytes 








136-37 


124-25 


|MCST 


1 Device status 








1 38-39 


126-27 


IMCLU 


[EXCP real plus LUB index (logical 


unit) 




140-43 


I28-2B 


IMCCA 


[ CCW address 








1 44-47 


I2C-2F 


|None 


[CCW address in CSW 








h 


~+ 


— ^ 


^± «.^^««.^^«.«, -.^-.«.-—- . «.«.«.-.^«.«.„ , 








... — Y ~- ~ — ^-.^„ — „ 


" ' "" " 


' " " " ■" '" ' " ■ 1- ■" - " 1 ■ 


" " "'■ " " 


1 


1 


|MCXT 


[Extent information 








\- 




— j, 


1 
















1 48-51 


130-33 


IMCLO 


[LOW limit (CCHH) 








152-55 


134-37 


IMCHI 


IHigh limit (CCHH) 








|56 


|38 


|MCSE 


[Sector value 








157-59 


I39-3B 


1 


[Reserved 








1 60-63 


I3C-3F 


IMCSX 


[Sector table address 









-i 



— ^ 



-+ 

I PIGCH 



[Channel program 

-X ^-. 



Figure 5.17 (Part 1 of 2/. Module Control Block 
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i Bytes 


— T 

1 


I 


"^ T 


1 




- JT^Hol 


|Descrirlion/f unction of field 




1 Dec 


1 Hex 


lof fie 




1 


1 


1 (Note 


^)| 




h 




-+ 




^ 


164-71 


1 40-47 


|MCSK 


ISeek CCW 




172-79 


|48-4F 


IMCSS 


|Set sector or TIC CCW 




1 80-87 


150-57 


IMCSH 


[Search CCW 




188-91 


I58-5B 


|MCTI 


|TIC CCW 




192-95 


1 5C-5F 


|MCTV 


1 Virtual address of buffer 




196-103 


160-67 


IMCRW 


iRead or write CCW 




1 104-107 


1 68-6B 


|MC$T 


1 Owner of i/o request (f TCB) 




1 108-111 


I6C-6F 


Imc$i 


1 Save area for register 1 




1- 


-f 


~-t 


...^ , ^ . . 


1 


1112-179 
1112-115 


I70-1B7 
«+ 

170-73 


1 
-+ 

1 MCNR 


|SLI support 


J 


1 SSL - No. of records/track 




1116-119 


174-77 


|MCNT 


1 SSL - No. of tracks/cylinder 




1 ■ 


■ r~ ~ "■' 


_ !_-- 


"" "T " " "■ - - — - — 




1120-179 


1 7 8-B3 


1 MCTS 


[Extension to sector table SSL (optional) 




1- 


-- 1- 


— -|. 


^. , . 


„ ^ 


1180-183 


IB4-B7 


1 


[Reserved 




L 


-L 




1 


J 



Figure 5.17, Module Control Block (Part 2 of 2) 

^ The labels in this control block vary according to the generated DSECT or 

declaration. The first characters are Ql for the queue file MCB, D2 for the DFILE2 
MCB, and MC for all other MCBs. 

■2 Seek and search address required by the channel program. Whenever an input or output 
operation is to be performed it is updated from the seek address pointer in the I/O 
Request Word (see Figure 5.12) that controls the operation. 

How to Locate 



K-..-y 



Refer to Figure 6.1 in Section 6, 
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TAPE CONTROL BLOCK (TBB) 



Definition macro: IPW$DTB 

This block is dynamically created to satisfy requirements of POWER/VS tasks utilizing 
tape as intermediate storage. Its format as it is printed in a dump is shown below: 



Dump fonfnat: 



TIOB 



-r— ♦- 



1— I 

Storage Descriptor 
I 



I 
CCB (EXCP Real) 



Reserved 
— I 

ccw 



Lock word 



( 



Bytes 



Dec 



|. , 

I 00-15 
1 16-27 
128-31 



I 



Hex 



--j_ . ^ . 

I Label | 
-^of field] Description/function of field 



I 00- OF 

IIO-IB 

|1C-1F 

-f 



F 

I 32-33 
134-35 
I 36-37 
138-39 
I 40-43 
144-47 

I 48-55 

L , 



+ 

120-21 
i22-23 
124-25 
126-27 
I28-2B 
|2C-2F 

"+ 

I 30-37 



-+ 

|TBSD 

I 
JTBLK 

-+ 

ITBCB 



Storage descriptor (TBB) 

Reserved 

Loc kword 



I Command control block 



|TBCT 
I TBCM 
JTBST 
ITBLU 
|TBCA 
I None 

.+ 

jTBCH 

-X 



Residual count 
Communication bytes 
Channel and device status 
EXCP real plus LUB index 
CCW address 
CCW address in CSW 



I Read or write CCW 
-X 



-H 



— ^ 



Figure 5. 18, Tape Control Block 

How to Locate 

Refer to Figure 6.1 in Section 6- 
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PAGE CONTROL BLOCK (PCB) 



Definition macro: IPW$DPC 



Each p^ge in the fixable area starts with this control block, which occupies the first 
2U bytes of the page,. The format of the PCB as it is printed in^a dump is shown below: 



24 bytes 



PCRA 


PCVP 


PCVA 


PCPC 


PCPA 


pcvn] 



h 



h 



h 



Bytes 



Dec 



00--03 



04-07 



08^-11 



h 



12--15 



h 



16-19 



h 



20-23 



I Hex 



00-03 



04-07 



08-OB 



OC-OF 



10-13 



14-17 



Label of 
field 



^CRA 



PCVP 



PCVA 



PCPC 



PCFA 



PCVN 



Description/function of field 



Page real storage address 

Real storage address of the page described by this PCB, 



Previous page virtual address 
VirtUc-1 storage address of the previous page in the fixed 
page list. If the present page is the first page in the 
fixed page list the word is set to binary zeros. 



This page virtual address 

This fullword contains the virtual storage address of the 
page described by this page control block. 
^ ^ . ^ „„. 

Page control byte address 

Contains the virtual storage address of the byte within 
the storage assignment block in the storage control block 
which corresponds to the present page. 

First buffer address 

This fullword contains the virtual storage address of the 

first storage buffer within the present p^ge. 



-H 



Next page virtual address 

This fullword contains the virtual storage address of the 
next page in the fixed page list,. If the present page is 
the last page in the fixed page list the word is set to 
binary zeros. 



v.,..y 



Figure 5.19. Page Control Block 

This is a usefiiL aid to convert the virtual address of a page to real when analyzing a 
standalone dump. 

For example, assume the contents of register 1 in a TCB within a page starting at real 
address E800 is 41AF4^. Assume alco that field PCVA of the page control block contains 
418 0Q. To find the real address contained in register 1: 

Ip 41AF4 lies within the page starting at virtual address 41800. 

2. Subtract that address (418 00) from 41AF4 and add the result to the address in field 
■ PCRA of the page control block, (E800). 

3. The result is the corresponding real address of the contents of register 1 CEAF4), 



o 
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c 



BUFFER CONTROL WORD (BCW> 



When a page is fixed in the fixable area, storage management assigns the first and last 
buffer control words. The first buffer control word is placed immediately after the page 
control block at the start of the page in real storage,, and the last buffer control word 
is placed in the last two words of the page. 

Real storage within the page is allocated by storage management from the last buffer 
control word. When storage is allocated to a buffer,, the last buffer control word is 
updated to reflect the size of the buffer, and a new buffer control word is created to 
immediately precede the buffer.. The newly created buffer control word will be used by 
storage management next time it requires space in the fixable area. This is more fully 
described in Section 2 of this manu&l c^nd DOS/VS POWER/VS Logic Part 2. Its format as it 
is printed in a dump is shown below: 



Length 

previous 

buffer 


Length 

next 

buffer 


Owner TCB address 



- 8 bytes ■ 






h- 



Bytes 



Dec 



1 



Hex 



00-01 



02-03 



h 



00-01 



02-03 



Label of 
field 



None 



None 



Description/function of field 



Length of previous buffer 



-H 



This halfword contains the binary length of the 
immediately-preceding storage buffer- If the buffer is in 
use its length is stored in twos complement form. If the 
buffer is not in use its length is stored in normal form. 
If the present buffer is the first in the page the word is 
set to binary zeros. 



H 



Length of next buffer 



This halfword contains the binary length of the present 
storage buffer, that is, the buffer which immediately 
follows this buffer control word in storage. If the 
buffer is in use its length is stored in twos complement 
form.. If the buffer is not in use its length is stored in 
normal form. If the preceding buffer is the last in the 
page the word is set to binary zeros. 



H 



04-07 



04-07 



None 



Owner (TCB virtual address) of next buffer. This fullword 
contains the address of the TCB belonging to the task 
which issued the request for buffer space. If a TCB is 
contained i.n the buffer, the owner address is that of the 
task which built the TCB. 



Figure 5.20. Buffer Control Word (Part 1 of 2) 
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Hex Code 



Alpha Code 
(translated output) 






Ht BCW 
00000360 00000000 I 




Figure 5.20.' Buffer Control Word (Part 2 of 2) 



This figure shows how to interpret BGWs in a standalone dump output. It illustrates a 
page containing seven buffer areas which contain control blocks that existed in the 
fixable area at the time the dump was executed. The size of each buffer in use can be 
seen recorded in t\70c cor.plement form, in the BGWs^ as well as the task which issued the 
request for buffer space. 



\_y 



PARTITION CONTROL BLOCK (PDB) 



Definition macro: IPW$DPD 

A partition control block is dynamically created for each partition to be controlled by 
POWER/VS. In addition to general partition information, the block contains an entry for 

each device that is to be spooled """^^ "= — — ^ -^^ "-' ^-.^-^ — ^- ^ ^i~>.. 

IPW$DTL macro instruction. 



The format of these entries is described by the 



h 



- 32 bytes " 



H 



Partition 
device < 
list 



PDB 



■V ' ^ ' ""— ■■ ■"" > !)■—■ ■■ ■ "■■■ ■■■ ■ ■■■ 

Storage Descriptor 



Address 
Pointers 



Reserved 



3540 Spool Device Entry 



Res. 



Part. 
ID 



Number 
of entries 



Part. 
Comreg. 



PIE 
address 



Statistical information 



RDR Device Entry 



LST Device Entries (16 bytes, dec, each) 
(maximum of 8, see Note) 



PUN Device Entries (16 bytes^ dec, each) 
(maximum of 8. see Note) 



Reserved 



(Space for 
Buffer Control Word) 



Figure 5.21, Partition Control Block (Part 1 of 3) 
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c 



Note : The number of entries in the LST and PUN device entry sections of this block 
depend on the number specified in response to the message: 

IQxxI PLEASE SPECIFY SPOOL DEVICES 

after entering the PSTART command to start a partition. 



^ 

I 
Label of I Description/function of field 
fields I 



Bytes 



Dec 



Hex 



H 



00--15 
16-17 
18-19 
20-23 
24-27 
28-31 



I- 



00- OF 
10-11 
12-13 
14-17 
18-lB 
IC-IF 



PSSD j Storage descriptor (PDB) 

I Reserved 
PDPI I Partition identifier 

PDNE 1 Number of entries 

PDCM I Partition comreg address 

PDPB |PIB address 



32-35 
36-39 

ao-47 



h 



20-23 
24-27 

28-2F 



PDPA j First entry address 
PDBB I Boundary box entry pointer 
I Reserved. 



Statistical information 

This information is destined for the execution account record and 
there is a pointer to the SLI work area. 

-r ^ 

PDSL 1 Pointer to SLI work area 

PD#L j Number of lines spooled 

PD#C [Number of cards spooled 

PD#P I Number of pages spooled 

PDOC j Default output class 

PDMT I Multitasking indicator 

JL 



48-51 

52-55 

56-59 

60-61 

62 

63 



30-33 
34-37 
38-3B 
3C-3D 

3£ 
3F 



+- 



3540 spool device entry (same format as RDR device entry) 



64-79 



40-4F 



PDER 



^ 



80-83 

84-87 
88-91 



92 
93 

94-95 



50-53 

54-57 

58-53 



RDR device entry (maximum = 1) 

^ 

PDPU [Address of entry in the DOS/VS PUB for a card reader 

I device 
PDTC [Address of execution reader TCB 
PDCB [CCB address. The first byte of this field is the SVC 

j code: 



[X'OO* = SVC 0: 
|X' 90' = SVC 90: 
|X'91' = SVC 91: 



I/O request by user program 
accounting request by PA 
accounting request by JCL 



5C 
5D 

5E-5F 



PDDT 
PDCL 

PDRQ 



[Device type code 
I Device class code 

jean be R = normal reader, or C = console 
[Requestor ID 
-X 



LST device entry (maximum = 8) 



96-99 

100-103 

104-107 

108 

109 

110-111 



60-63 

64-67 

68-6B 

6C 

6D 

6E-6F 



TLPU^ 

TLTC^ 

TLCB 

TLDT^ 

TLCL 

TLRQ 



[Address of entry in the DOS/VS PUB for a printer device 

[Address of the execution list TCB 

I CCB address 

[Device type code 

jlor list device entry this can be L = device is being 

[spooled, N = device is not being spooled. 

[ Requestor ID 



Figure 5.21. Partition Control Block (Part 2 of 3) 
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. — •.-.^•^ . — *^«-. .-.-. — .— ^^ ^ -. — 

Bytes I I 

j.- *•., . — -j Label of | Description/function of field 

Dec I Hex j field | 

Depends on number |PUN device entry (maximum = 8) 
of LST entries j (same format as LST device entry) 
-, + ^. 



— ^ 




JTLPU i Address of entry in the DOS/VS PUB for a punch device 

|TLTC [Address of the execution punch TCB 

|TLCB JCCB address 

JTLDT I Device type code 

JTIiCL I For punch device entry this can be P = device is being 

I jspooled-t N = device is not being spooled. 

I TLRQ I Requestor ID 

.X X -. ^ ■ . ._. 






Figure 5.21. Partition Control Block (Part 3 of 3) 

How to Locate 

Refer to Figure 6.1 in Section 6,. 

QUEUE RECORD AREA (QRA) 



Definition macro: IPW$DQR 

This area is used in conjunction with the auxiliary queue record area in the disk 
management block. Each task that processes a queue record acquires a QRA to contain the 
record. 

The format as it is printed in a dximp is shown below: 



\... y 



Hex 



32 bytes" 



00 








































































1 80 


1^ Reserved ■ — 


Switch 






1 ^ 


QRNS I 




Reservec 




QRQP 


QRQN 


QRDF 







Body 
field 



Control 
field 



I Figure 5.22 Queue Record area (Part 1 of 3) 






166 DOS/VS POWER/VS Logic 



Page of Sy33-8576-1, Revised November 28, 1977, By TNL SN33-9240 



C 



c — •- ~ ■ ■' ' ' T- ■•> ••■ - 


""■"""——"""■*" ""•"•" 


"— T '*"'"''""""'""'""" T'^'"'"""'*"^ """"""*""""" '"'"'"*""** ■««---•-----————————-«•—————■——— —.—«-—————- 


m -n T rii Tir i. m mi (^ 


1 Bytes 




1 


Description/function of field. Refer to the Disk 




r T 


■•""T JLldUCZX *-'J_ 




1 Dec 
1 


1 Hex 


Ifieldi- 1 
1 


Management Block (DMB) auxiliary queue record area 
fuller description of the individual entries. 


for a 1 


1- ^ 

1 


h 


|Body Fields (first 136 bytes) referenced by label QRBF 


— ^-^—-—^ 


1 




|The body 


of the queue record contains information pertinent 


to thisj 


1 




1 particular queue entry and the user job which created it. 




L «.— «^^^^. 


1 


— X^— ^-.^ ™^ 




[■ 


r — 


l"^*— '" " ^ ■■' *"•" 


— ^ — P 


"*""""""'" ■'""■■ "^ 


1 00-07 


00-07 


|,QRDYi 


Date 




108-11 


108-OB 


IQRST 


Operation start time 




112-15 


OC-OF 


1 QRET 


Operation end time 




116-31 


IIO-IF 


IQRUI 


User information 




1 32-39 


1 20-27 


IQRNM 


Job name 




|40-m 


128-29 


IQRNO 


Job number 




|42 


12A 


IQRQI 


Queue record identifier 




|U3 


|2B 


IQRCN 


POWER/VS cancel code 




1 UU 


|2C 


IQRRJ 


Line identifier or device type 




1 45-47 


I20-2F 


IQRCU 


Channel and unit (line address) 




1 48 


1 30 


IQRFJ 


From terminal identifier 




|49 


|31 


IQRTJ 


To terminal identifier 




|50 


|32 


IQRCL 


Class 




|51 


|33 


IQRPY 


Priority 




1 52-55 


134-37 


1 QRNR 


Record count 




156-57 


138-39 


IQRNT 


Number of tracks 




|58 


|3A 


1 QRSN 


Job suffix number 




|59 


|3B 


IQRNC 


Number of copies 




1 60-63 


1 3C-3F 


IQRFI 


Forms identifier 




164-67 


140-43 


IQRNA 


Number of additional records 




168-69 


1 44-45 


IQRNP 


Number of pages 




170-71 


146-47 


IQRNE 


Number of extra pages 




172-75 


1 48-4B 


IQRLC 


[Line/card counter 




176-79 


I4C-4F 


1 QRRR 


Restart page count 




1 80 


|50 


1 QRCR 


Copies remaining 




|81 


|51 


IQRDI 


Not used 




|82 


|52 


IQRDP 


[Disposition 




|83 


|53 


1 QRSP 


Number of separators 




1 84-87 


1 54-57 


IQRBS 


Number of records before split 




188-91 


I58-5B 


IQRBM 


Maximum value of count 




192-95 


I5C-5F 


IQRBN 


[Additional count value 




196-97 


160-61 


IQRER 


Physical 3540 device address (packed) 




1 98-99 


1 62-63 


1 QRJ# 


Save job number for accounting 




1100-103 


j 64-67 


jQRCP 


Compaction table name 

L 




I 


1 


T 
__i 


r 

13800 Printer Control Information 




' 104-107 


]68-6B 


Iqrfl 


|. ^ 

[Flush identifier 




1 108-115 


160-73 


Iqrcg 


iCopy groups 




1 116 


174 


IQRTC 


I Total number of transmissions 




1 117 


|75 


JQRCI 


Current copy group index (restart purposes) 




1 118 
1 


'76 


iQRPS 
QRBR 


' Paper status (3800 only) 
C'B' burst threading 




1 


1 _ 


1 _ ______—-.____ __-. _-_—__——. 







t 


■~~ 


|. 




119 
1 


177 


IQROP 
IQRCS 


[Option byte 

|X''20' no separator pages between copies 




' 120-123 


|78-7B 


1 


[Reserved for future use 




1 124-135 


I7C-87 


""r 


Unused 




L 


i 


„i 




____-.__~ J 



Figure 5.22 Queue Record area (Part 2 of 3) 

^ The labels in a queue record vary according to the generated DSECT, The first two 

characters are queue record in a present queue record, QN in a "next" queue record, and 
QP in a "previous" queue record. 
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Byt 
Dec 



as 



i[- 



Hex 



— 1 Label of , Description/function of field. 
I field ^ I Management Block (DMB) auxilic 



Refer to the Disk 



I 

4- 



Lary queue record area for a 

I fuller description of the individual entries. 

-X . . . 



I Control Fields (4 8 bytes) referenced by label QRCF 
I The control portion of the queue record contains information 
I relating to the status of the queue record and to its position 
I within the POWER/VS queues. 

I Execution switch 

I First in set switch ^ 

I Segmentation type 

[Reserved 

I Next record in set ^ 

I Previous set in queue ^ 

I Next set in queue ^' 

I First block of data 



I Figure 5.22 Queue Record area (Part 3 of 3) 

2 The contents of field QRFS can be X'OO' or X"01'. 

X'Ol' indicates that the queue record is the first in the queue set. 
X'OO* indicates that the queue record is not the first in the queue set-. 

This determines the meaning of the fields QRNS,, QRQP, and QRQN as follows: 

QRFS = X'OO' (This queue record is not first in Q set) 



1- 


-+ 


— + 


1 136 


1 88 


IQRXS 


1 137 


|89 


IQRFS 


1 138 


1 8A 


IQRSG 


1 139-151 


I8B-97 


1 


1 152-159 


I98-9F 


1 QRNS 


1 160-167 


IA0-A7 


IQRQP 


1 168-175 


IA8-AF 


IQRQN 


1 176-183 


IB0-B7 


IQRDF 


L 


*. X_ — ..— . .i. ~ . 


1 



r — ' T • 

I Label of Field I Field contains zero 

h 



IQRNS 
I 



h 

IQRQP 

I 

I 

h 

I QRQN 
L 



I This queue record is the 
[last in this queue set. 



j Cannot be zero. 

I 

I 



j Field does not contain zero j 
+ __^ 

I It is seek address of next queue j 
I record in this queue set. j 

H 



I It is the seek address of the 
] first queue record in this 
j queue set. 



jMust be zero- 
-X 



1 Must be zero. 

-x , .. 



V, _..,^' 



QRFS = X'Ol' (This queue record is first in queue set) 



j Label of Field] Field contains zero 



j Field does not contain zero j 



h 



QRNS 



I This queue record is last 
I in same queue set. 



T 

I It is the seek address of the 
I next queue record in this 
j queue set. 



QRQP 



h 



QRQN 



JThis queue record is the 
I first in the first queue set 
I in this class chain. 
.+ .^^ 

jThis queue record is the 



I It is the seek address of the 
j first queue record of the 
I previous queue set. 

j It is the seek address of the 



I first queue record of the last [next queue set in this class 
I queue set in this class chain- 1 chain. 

-X X 



This is illustrated in Figure 5.U8,, Part 9 



How to Locate 



Refer to Figure" 6.1 in Section 6. 



C 
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SLI WORK SPACE (SLW) 



Definition macro: IPW$DSL 



This work space is reserved and used by phase IPW$$SL and provides storage to read blocks 
from a source statement library and to deblock the records. The format of the block as 
printed in a dump is shown below: 



32 bytes • 





Logical Record (80 bytes) 






SSL Block (160 Bytes) 




Disk Request Word | 


R8 Save Area 


SUBLIB Book Name | | Alignment J 



, ^ ^ 

Bytes I Label of | 

-_, — P 4 field in j Description/function of field 

Dec I Hex I IPW$$NU I 



-H 



j 00-79 100-49 ISLLR JLogical record work area 
|. ^ + .^ 

180-239 I50-E9 | SLPB | SSL block work area 

^ ^. ^„„+ + 

I I I SLRW jDisk request word 



1240-247 IF0-F7 | SLSW 

I I I 

1248-251 IF8-FB | SLSA 

1252-255 IFC-FF | SLSV 

1256-259 1100-103 | SLR8 
I 



I Seek address CMBBCCHHR) M = index in module control block 
[address table in CAT. 
I Real address read- in area 
[Virtual address read-in area 
..+ ^ 

I Register 8 save area 






I 



ISLNM 
[. . „+ +^« 

I 260 1 104 JSLSL 

1261-268 I 105- IOC | SLBM 



! SLI sub library and bookname 
>+ ^„™ 

I Sublibrary name 
I Bookname 



]269 |10D ISLRS 
I 270 |10E [SLRR 
|. 1 . ^^ 

1271-279 llOF-117 | 

L JL X 



I Read SSL switch 
[Read RDR switch 
.+ 

I Filler for alignment 

.X 1 



c 



Figure 5.23. SLI Work Space 

How to Locate 

Refer to Figure 6.1 in Section 6, 



Section 5: Layout of the POWER/VS Data Areas 169 



ACCOUNT • CONTROL BLOCK (ACB) 

Definition macro: IPW$DAC 

The ACB is used only by job accounting support. It is used to control account records 
contained on the account file 'IJAFILE' (SYSOOO)- 

The ACB is initialized for PUT mode. The mode is changed into GET mode when the save 
account -task issues a IPW$OAF macro. The format of the block as printed in a dump is 
shown below: 



Hex 
00 

20 

40 

60 

AO 



-32 bytes- 



ACB Storage descriptor 


ECB 


LO extent 


HI extent 


Lockword 


CCB 


Current seek address 




Count 


Capacity Fields 


Tracks 
cylinder 


Sector 


Tol. 


over-, 
head 


Device 
types 


Channel Program 






Channel Program Modifiers 


Channel Frogranfi Modifiers 


Address Account 
Work Space 













I Dec 
I- 

100-15 
I 

I 16-19 



Bytes 



I 



h~ 

I 20-23 

I- ~- 

124-27 
|. 

I 28-31 
j. 



I™ 

I 32-33 
134-35 
I 36-37 
138-39 
I 40 

141-43 
I 44 

145-47 
|. .. 

I 48-54 
|55 

F- 

I 56-63 
j.^ 

I 64-67 

I- 

I 68-71 



I 

|00 
110- 



— - — ™| Lcibel I Description/function of field 
Hex I of field] 



-OF |ACSD j Storage descriptor (ACB) 

+ 1_^^^ . 

■13 |ACEB [Event control block 

I I This ECB is posted when the account file is emptied. 



14- 



|18- 
|1C- 



17 
IB 
IF 



|ACLO [Extent lower limit 
.+ ^^^ ^ 

I AC HI [Extent upper limit 



I ACLW 



[Lockword 



I 

[20- 

[22- 

[24- 

[26- 

[28 

[29- 

I2C 

[2D- 



i Command Control Block (referred to by label ACCB) 



I 30- 
[37 



21 
23 
25 
27 

2B 

•2F 

36 



[ACCT 
jACCM 
1ACST 
[ACLU 
j None 
[ACCA 
I None 
[ACCS 



[Residual count 
I Communication bytes 
[Device status 
] Logical unit 
[Reserved fOr LIOCS 
I CCW real address 
[Reserved for PIOCS 
[CCW address in CSW 



I ACS A 
I None 



[Current seek address (BBCCHHR) 
[Reserved 



[ 38- 



[40- 



[44- 



3F 
43 
47 



JACCF [Count field 
.+-.^ «+ „ 

I ACMC [Maximum account file capacity 



[ACEC 

-X — 



[20% limit residual capacity 

.J. . . - , 



-H 



KJ 



Figure 5.24. Account Control Block (Part 1 of 2) 
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( 



h- 



h 

80^83 I 50--53 | ACLC |Residual capacity on current track 

84-87 I 54-57 | AC#T | Number of tracks per cylinder 



^ ^ 

Bytes I I 

J. -JLabel j Description/function of field 

Dec I Hex I of fieldj 



72-75 
76-79 



I 48-UB 
"f 

|4C-4F 



|ACAC 

-+ 

I ACMT 



[Current residual capacity 
-+ 

I Maximum track capacity 






88-89 

90-91 

92-93 

94 

95 



j 58-59 |ACSE j Sector values 

15A-5B jACTL | Tolerance 



I 5C-5D I AC OH I Overhead 

.^. ^ + . 

|5E |ACPB I PUB device type code 



5F 



96-103 

104-111 

112-119 

120-127 

128-143 

144-151 



h 



-+ 

I 60-67 
|68-6F 
I 70-77 
I78-7F 
I 80- 8F 
190-97 



|ACDT JDTFPH device type code 
.+ X . . 

[Channel Program (referred to by label ACCH) 



|ACSK [Seek CCW 

|ACSS I Set sector or TIC * +8 CCW 

|ACSH I Search ID equal CCW 

[ACTI I TIC * -8 CCW 

JACRW |WCKD CCWs (WCOUNT and WDATA) 

|ACRS I Read sector CCW or not used 



152-167 I 98-A7 JACPM [Channel program modifiers RDATA and RCOUNT CCWs 
168-171 |A8-AB | ACWA [Virtual address account work space buffer 
17 2-18 3 |AC-B7 [None |Not used 

X X X 



— ^ 






— ^ 



-^ 



-H 



J 



Figure 5.24. Account Control Block (Part 2 of 2) 

How to Locate 

Refer to Figure 6.1 in Section 6. 

ACCOUNT WORK SPACE (AWS) 

DSECTname : LADS 

The account work space contains counters used for building account records by the -logical 

writer IPW$$LW. 



Bytes 



Dec 



I 

h 

100-03 

104-07 

108-11 

I 12-13 

114-15 

116-17 

|18 

I 19 

120-23 

L . 



|00- 
I 04- 
|08- 
I OC- 
|0E- 
|10- 
112 
|13 
I 14- 
-J 



T T 

I i 

JLabel 1 Description/function of field 

Hex jof fieldl 
+- 



03 
07 
OB 
OD 
OF 
11 



17 



JLAER j Extra lines/cards 

JLACR I Current line/card 

1 LARC I Restart current page/card 

Jlaep 1 Extra pages 

|LATP I Total pages from data file 

1 LACP I Current page 

ILASR 1 START after PSTOP cuu^ restart indicator 

I LAWS I Work field for copy count 

I LAST I Task start time (OHm/IMSSF) 



-1 



Figure 5.25. Account Work Space 
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READER ACCOUNT RECORD 



A reader accoimt record is created for each read queue entry that is entered into the 
POWER/VS system. Whether or not the queue entry has actually been placed in the queue 
file is indicated by the POWER/VS cancel code. The record is copied from the first 58 
bytes of the corresponding queue record. 

The record shown is the logical record. On the account file IJAFILE and after saving 
from account file onto tape or disk they are contained as SAM physical records (including 
8-byte record control field as shown in the DMB auxiliary account record area). 

When saved on punched cards they will appear in columns 2-72. Column 1 of every card 
contains a copy of the record identifier (byte 42) of the record,, columns 73-78 contain 
the sequential account record number,, and columns 79-80 contain the sequential card 
number within that record ( = 01),. 



'"^^....y' 



I Bytes 



00-07 
08-11 
12-15 
16-31 
32-39 

ao-41 

42 

43 

44 

45-47 

48 

49 

50 

51 

52- 



55 



56- 
F 



57 



.^ ^ , . , ^ ^ 

I Description j Format*^ | 

Date in format specified at SYSGEN (mm/dd/yy or dd/mm/yy) ] a 

Start time of read, in packed decimal (OHHMMSSF; F = sign) ] p 

Stop time of read (OHHMMSSF; F = sign) ! P 

16 bytes of user information ] a 

POWER/VS job name j a 

Job number assigned by POWER/VS I t> 

Record identifier (R) | a 

POWER/VS cancel code (see DMB) | b 

Reserved lb 

Reader device address, or SUL I ^ 

FROM remote ID ] b 

TO remote ID I t> 

Input class ! ^ 

Input priority number ] a 

Number of records read (including records added or deleted by an RDR j b 

exit routine) j 

Number of tracks for input storage | b 



stands for alphameric 

stands for binary 

stands for packed decimal.. 



^ a 

b 
P 

Note: The TO remote-id is a d\immy entry in the Reader Account Record and in the 
Execution Account Record. It is copied from the FROM remote-id. 



Figure 5.26. Reader Account Record 



4' "^^ 
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( 



LIST ACCOUNT RECORD 



A list account record is created for each list queue entry that is processed by a list 
task. It is a copy of the first 72 bytes of the corresponding queue record. 

The record shown is the logical record. On the account file IJAFILE and after saving 
from account file onto tape or disk they are contained as SAM physical records (including 
8-byte record control field as shown in the DMB auxiliary account record area). 

When saved on punched cards they will appear in columns 2*72. Column 1 of every card 
contains a copy of the record identifier (byte 42) of the record,, columns 73-78 contain 
the sequential account record number, and columns 79-80 contain the sequential card 
number within that record. 



j Bytes i Description 



( 



00-07 

08-11 

12-15 

16-31 

32-39 

40-41 

42 

43 

44 

45-47 

48 

49 

50 

51 

52-55 

56-57 

58 

59 

60-63 

64-67 

68-69 
70-71 



Date in format specified at SYSGEN (mm/dd/yy or dd/mm/yy) 

Start time of list, in packed decimal (OHHMMSSF; F = sign) 

Stop time of list (OHHMMSSF; F = sign) 

16 bytes of user information from * $$ JOB card 

POWER/VS job name 

Job number assigned by POWER/VS 

Record identifier (L) 

POWER/VS cancel code (see DMB) 

Reserved 

Printer device address, or SNA 

FROM remote ID 

TO remote ID 

Printed output class 

Printed output priority number 

Number of lines printed 

Number of tracks for output storage ^ 

Job suffix number assigned by POWER/VS *♦ 

Number of printed copies ^ 

Print forms identification 

Number of extra records printed due to PRESTART or PSETUP or 

separator lines 

Number of pages printed (skips to channel 1) 

Number of extra pages printed due to PRESTART or PSETUP or separator 

cards 



i Format^ | 



Only for spooling to disk. When tape spooling, field is zero. 

If more than one copy is provided., the statistics are totals for all copies. 

When a 3800 Printer has been used, indicates the total transmission count. 

a stands for alphameric 

b stands for binary 

p stands for packed decimal-. 

Will be X'FF* for last or only segment of job. 



P 
P 
a 
a 
b 
a 
b 
b 
a 
b 
b 
a 
a 
b 
b 
b 
b 
a 
b 

b 
b 



-1 



Figure 5.27. List Account Record 
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PUNCH ACCOUNT RECORD 



A piinch account record is created for each punch queue entry that is processed by a punch 
task. It is a copy of the first 64 bytes of the corresponding queue record. 

The record shown is the logical record. On the account file IJAFILE and after saving 
from account file onto tape or disk they are contained as SAM physical records (including 
8-byte record control field as shown in the DMB auxiliary account record area). 

When saved on punched cards they will appear in columns 2-72.. Column 1 of every card 
contains a copy of the record identifier (byte 42) of the recor<l> columns 73-78 contain 
the sequential account record number^ and columns 79-80 contain the sequential card 
number within that record. 



X. ..y 



j Bytes j Description 



00-07 

08-11 

12-15 

16-31 

32-39 

40-41 

42 

43 

44 

45-47 

48 

49 

50 

51 

52-55 

56-57 

58 

59 

60-63 

64-67 



Date in format specified at SYSGEN (mm/dd/yy or dd/mm/yy) 

Start time of punch, in packed decimal (OHHMMSSF; F = sign) 

Stop time of punch,, (OHHMMSSF; F = sign) 

16 bytes of user information from * $$ JOB card 

POWER/VS job name from * $$ JOB card 

Job number assigned by POWER/VS 

Record identifier (P) 

POWER/VS cancel code (see DMB) 

Reserved 

Punch device address, or SNA 

FROM remote ID 

TO remote ID 

Punched output class 

Punched output priority number 

Number of records punched 

Number of tracks for output storage ^ 

Job suffix number assigned by POWER/VS *♦ 

Number of punched copies ^ 

Punch forms identification 

Number of additional cards punched due to restart or separator cards 



j Formaf^ | 
•+~ — -H 



Only for spooling to disk. When tape spooling, field is zero. 

If more than one copy is provided,, the statistics are totals for all copies. 

a stands for alphameric 

b stands for binary 

p stands for pecked decimal* 

Will be X'FF' for last or only segment of job. 



a 
P 
P 
a 
a 
b 
a 
b 
b 
a 
b 
b 
a 
a 
b 
b 
b 
b 
a 
a 



V y 



Figure 5.2 8. Punch Account Record 



EXECUTION ACCOUNT RECORD 



DSECT name: AEDS 



An execution account record is created for each queue set (user job step) that has been 
processed by POWER/VS. 



The record shown is the logical record. On the account file IJAFILE and after saving 
from account file onto tape or disk they are contained as SAM physical records (including 
8-byte record control field as shown in the DMB auxiliary account record area). 
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c 



when saved on punched cards they will appear in coliimns 2-72. Column 1 of every card 
contains a copy of the record identifier (byte 42) of the record, columns 73-^78 contain 
the sequential account record number, and columns 79-- 80 contain the sequential card 
number within that record. 



Bytes 
00-07 



08 
12 
16 
32- 

ao 

42 
43 
44 
45 
48 
49 
50 
51 
52 
56 
60 
62 
64 
66 
72 
80 
9 6 
98 
99 
100 
104- 
112 
116 



'11 
•15 
■31 
'39 
■41 



-47 



•55 
-59 
■61 
-63 
■65 
-71 
•79 
-95 
■97 



-103 
•111 
■115 
•119 



T ' 

I Label 
I 

AEDY 

AEST 
AEET 
AEUI 
AENM 
AENO 
AERI 
AECN 
AERJ 
AECU 
AEFJ 
AETJ 
AECL 
AEPY 



I Description 



1 Format^! 



h- 



Date of execution in format specified at SYSGEN (mm/dd/yy or] a 

dd/mm/yy) ] 

Start time of job (OHHMMSSF; F = sign) \ p 

Stop time of job (OHHMMSSF; F = sign) j p 

16 bytes of user information ] a 

Current POWER/VS job name | a 

Job number assigned by POWER/VS j b 

Record identifier (E) ] a 

POWER/VS cancel code (see DMB) ] b 

Reserved 1 b 

Reserved j b 

FROM remote ID | b 

TO remote ID j b 

Class ] a 

Priority j b 

Number of lines spooled ) b 

Number of cards spooled j b 

Number of pages spooled j b 

Length of SIO table j b 

Length of total account record | b 

Reserved j 

DOS/VS job. name from // JOB card j a 

16 bytes of user information from // JOB card [ a 

Partition-id in EBCDIC format ] a 

DOS/VS cancel code | b 

Type of record; S = job step., L = last step ] a 

Reserved j 

Phase name,, taken from execute card 1 a 

End address of active program phase, from COMREG j b 

CPU time elapsed in a job step; counted in 300ths of a 1 t) 

second j 

Overhead time; elapsed time not charged to any partition, in] b 

300ths of a second ] 

All-bound time; system wait state time divided between | b 

running partitions,, in 300ths of a second j 

SIO tables: 6 bytes for each device specified by SYSGEN ] b 

options, as follows: j 

two bytes for device address .( Ocuu) , j 

four bytes for count of SIOs in current job step ^ | 

Overflow byte: normally X' 20', but X'30* if more devices are] b 

used within a partition than specified by SYSGEN options ] 

User account information (provided via user PUTACCT macro) j 

± i 



120-123 
124-127 
128- 



^ POWER/VS will update the SIO tables in the execution account record with the number 
of I/Os it has intercepted for spooling purposes. 



"H 



^ a stands for alphameric 
b stands for binary 
p stands for packed decimal 



3 Maximum length of execution account record is 2008 bytes. 



Figure 5.2 9. Execution Account Record 
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RJE ACCOUNT RECORDS 



\^' 



A line account record is created for each RJE,BSC user session when signoff or line 
is processed. It is a copy of the first 56 bytes of the Line Control Block. 



stop 



The record shown is the logical record. On the account file IJAFILE and after saving 
from account file onto tape or disk they are contained as SAM physical records (including 
8-byte record control field as shown in the DMB auxiliary account record area). 

When saved on punched cards they will appear in columns 2*57. Column 1 of every card 
contains a copy of the record identifier (byte 50) of the record, columns 73--78 contain 
the sequential account record number, and columns 79-80 contain the sequential card 
number within that record. 

. . _ , . ^ ^ 

Description ] Format^] 




Date in format specified at system generation mm/dd/yy or dd/mm/yy ] a 

Signon time in packed decimal (OMMMMSSF; F=sign) j p 

Signoff time (OMMMMSSF; F=sign) | p 

16 bytes user information j a 

Line password j a 

Reserved 1 h 

Record identifier (T) j a 

Signoff code 1 t> 

X'Ol' - Normal signoff ] 

X'02' - Signoff forced due to central stop | 

X'04' - Signoff forced due to excessive idle time | 

X'08' - Signoff forced due to unrecoverable I/O error j 

Terminal error count ] 

Line address | 

Remote identifier 1 

1 

Transmission count per session \ 

Timeout count per session j 

Error count per session j 



V_y 



a stands for alphameric 

b stands for binary 

p stands for packed decimal 



Figure 5.30. Part 1: RJE,BSC Line Account Record 



O 
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A session account record is created when an RJE^SNA user session is terminated, 
copy of bytes 32-79 of the SNA unit control block- 



It is a 



The record shown is the logicc.1 record. On the account file IJAFILE and after saving 
from account file onto tape or disk they are contained as SAM physical records (including 
8-byte record control field as shown in the DMB auxiliary account record area)* 

When saved on punched cards they will appear in columns 2-57. Column 1 of every card 
contains a copy of the record identifier (byte 42) of the record, coliomns 73-78 contain 
the sequential account record number, and columns 78-80 contain the sequential card 
n\imber within that record. 



( 



Bytes 


Description ; 


Format^ 


dec 




1 


1 


L J. 




r 


00-07 


Date in format mm/dd/yy 


a 


08-11 


Signon time (OHHMMSSF; F=sigr.) 


P 


12-15 


Signoff time (OHHMMSSF; F=sign) 


P 


16-31 


16 bytes of user information 


1 ^ 


32-39 


Logical unit name 


a 


40-41 


Reserved 




42 


SNA record identifier (S) 


a 


43 


Session termination code 

1 X'Ol' - normal termination (LOGOFF or SIGNOFF) 
X'02' - abnormal termination 


1 b 


44-47 


1 Remote identifier 


1 b 



„.X ^ ^ X ^„-.^ 

^ a stands for alphameric 
b stands for binary 
p stands for packed decimal 



Figure 5.30. Part 2: RJE^SNA Session Account Record 
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RJE CONTROL BLOCKS; 



The major control blocks used by POWER/VS RJE are the Line Control Block (LCD) and the 
Buffer Control Area (BCA) . 

Line Control Block (LCB) 



The line control block describes the line and its status. It contains an entire line 
account ,record., which is completed and written to the account file at SIGNOFF time. It 
also contains the terminal characteristics, which are copied from the remote table in 
virtual storage at SIGNON time. 

When the line is started by the central operator^ an LCB is built for that line in real 
storage. It is not released before the line is stopped. One LCB is always corresponding 
to each active line,, independent of the number of reader and writer tasks operating on 
the line. 

Buffer Control Area (BCA) 



..^ 



The buffer control area contains the CCB., a CCW string, and all other information used to 
perform a line operation., such as mode bytes and sense information. Like the LCB, the 
BCA is built in real storage when the line is started, and released when the line is 
stopped. For hardware terminals,, one BCA is used for all line operations. 

The format of an LCB with 1 BCA as printed in a dump are shown below: 



- 32 bytes- 




Line Accqunt Information- 



Remote Blocic 



LCB 



..^' 



CCB- 



CCW 2 



CCW 6 



CCW 3 



CCW 4 



CCW1 



CCW 5 



EBCDIC/ASCII code table 



Other R J E,BSC information 



BCA 



Figure 5.31. RJE Line Control Block and Buffer Control area 
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LINE CONTROL BLOCK (LCB) 



Definition macro: IPW$DLC 



( 



h 



Bytes 



Dec 



00-07 
08-15 
16-19 

20-23 

24-39 

40-47 

48-49 

50 

51 

52 



53-55 

56 

57 

58-59 

60-61 

62-63 



Hex 



^ Label of 
field^ 



h 



64-67 
68-71 



72-75 



00-07 
08- OF 
10-13 

14-17 

18-27 

28-2F 

30-31 

32 

33 

34 



35-37 

38 

39 

3A-3B 
3C-3D 

3E-3F 



40-43 
44-47 



48-4B 



LCBHEAD 
LCBDATE 
LCBTIMON 

LCBTIMOF 

LCBUSER 
LCBPSWD 

LCBRECID 
LCBSCODE 
LCBERRCT 



LCBDEVAD 
LCBJD 

LCBTSMIT 

LCBIDLE 

LCBERROR 



LCBBUFAD 
LCBCHAIN 



LCB WORK 



Description/function of field 



H 



LCB header (LCBbbcuu) 

System date in format specified at SYSGEN 

SIGNON time in format OHHMMSSF; F = sign in packed 

decimal 

SIGNOFF time in format OHHMMSSF; F = sign in packed 

decimal 

User information 

Line password 

Reserved 

Line account record identifier (T) 

SIGNOFF code 

Terminal error count. This count is only maintained for 

intervention required and for specific timeouts. When 

the count reaches 10 a record is written to SYSREC 

(error recorder file)." Then the count is reset to zero. 

When it reaches 10 again, the same sequence occurs. 

Line address (in alpha) 

Remote identifier (in binary) 

Remote identifier (for compatibility) 

Traiismission count per session 

Timeout count per session 

Error count per session 

+ ^ 

Corresponding BCA address 

LCB chain pointer. A chain of LCBs is maintained and is 

continuously scanned by the line manager. Up to 25 LCBs 

can be chained,, the last LCB in the chain has in this 

field,. 

Work field 

. ^ - - J 



c 



Figure 5.32. Line Control Block (Part 1 of 4) 



Section 5: Layout of the POWER/VS Data Areas 179 



Bytes 

P 

Dec I Hex 



16-19 



80-83 



84-87 



88-89 



90-91 



92 



93 



4C-4F 



50-53 



54-57 



58-59 



5A-5B 



5C 



5D 



Label of 
fields 



LCBREMID 



LCBLlST 



LCBPUNCH 



LCBTMCNT 



LCBTMOUT 



LCBFEAT 



LCBFLA.GS 



Description/function of field 



Remote identifier 

This 4- byte field consists of: 



v-O--;- 



Remote ID Remote ID 
in binary in alpha 



For example 00000001 



FO FO F1 = remote ID of 1 



List output classes. Each byte in this 4-byte field 
contains a hex displacement in the LST part of the MCTA in 
the DMB. The displacement contained in one of the bytes 
therefore corresponds to a class. 

Up to four classes may be specified,, being delimited by 
X'FFV in a similar manner to that in the TCCT field in the 
T'CB. 

For example, the command * .,. START LST^B^C^D would result 
in the displacements 18, IC„ 20 being placed in this 
field. (Byte 3 would be X'FF')<. If no START LST command 
is entered the first byte of this field is FF. 

Punch output classes. Each byte, in this 4-byte field is 
used in the same way as in field LCBLIST, displacements 
being in the PUN part of the MCTA. 

Timeout counter. This field counts the number of timeouts 
(1 every 3 seconds) as long as the terminal is idle (no 
data transfer) . When information is transmitted on the 
line it is set to zero- The count is compared with the 
timeout limit specified in the PLINE macro. 

Timeout limit. The value in this field is specified by 
the TIMEOUT parameter in the PLINE macro. If the user 
specifies 1 (one minute) the value set in this field is 
binary 20.. The maximum timeout that may be specified is 
255 minutes. If the idle time on the line as counted in 
the field LCBTMCNT exceeds the value of field LCBTMOUT the 
terminal is signed off by POWER/VS. If TIMEOUT=KO is 
specified, this field is filled with binary zeros. 

Line features 

B'lxxx xxxx' - ASCII code line 

B'xlxx xxxx' - Transparent feature 

B'xxxx xxxl" - Switched line 

B'xxYYYYYx" - ooYYYYYo is mode byte for 2701 

LCB flags 

X'80' Line stop 

XV40' Line start/restart 

X'20' An ETX has been received 

X'lO* No messages wanted "* 

X'08' Remote is signed on 

X'02' SIGNOFF card has been read 

X'Ol'* Signoff (processing finished) 



K ,.y 



J 



Figure 5.32.. Line Control Block (Part 2 of 4) 
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( 



Dec 



Bytes 

-T — 



Hex 



94 



95 



96-99 



5E 



5F 



60-63 



Label of 
field^ 



LCBOUT 



LCBMSG 



LCBTCBAD 



Description/function of field 



Output switches 

X'80" = list output is ready and dispatchable for any of 

the classes started. 
X'08' = punch output is ready and dispatchable for any of 

the classes started. 

On START LSX, field LCBOUT is initiated with X'80r. 
On START PUN, field LCBOUT is initiated with X'08». 

Message subchain index. This byte contains the entry 

number in the message queue that contains the first 

message queued for this LCB- The illustration below shows 

three mesjsages queued for a line owning what we shall call 

LCB A. So, 

field LCBMSG in LCB A will contain 00, 

field LCBMSG in LCB N will contain 01, 

field LCBMSG in LCB K will contain 02, 

field LCBMSG in LCB F will contain 54. 



J04| Free queue pointer in the CAT 




LCBF 
LCBK 
LCBN 
LCB A 



A total of 255 messages each of 51 bytes (dec) 
' can be queued in the message queue 



X'FF' indicates end of queue for the LCB or 
end of free queue entries. 



Reader TCB address. This field contains the reader TCB 
address as long as the reader is active. It is set to 
binary zero when an RDR TCB is detached. If an EOF is 
encountered in the middle of a job, TCB space is not 
released, and the field is not set to zero. After the 
user responds by placing more cards in the reader the 
reader TCB will be reactivated. 

To summarize: 



± X 



If the field is zero, a new TCB is created, 
is nonzero,, the original TCB is reactivated. 



If the field 



Figure 5.32. Line Control Block (Part 3 of 4) 
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I. „.+ + .^^ 



Bytes 



T- 



„.„ ^ ^ 



Dec 



I 



Hex 



100-103 
104-107 
108-109 
110-111 



164-67 

68-6B 

I6C-6D 

, 6E- 6F 



H 



112-119 170-77 
Remote Block 

T 



Label of | Description/function of field 
field^ I 

LCBLFORM|List forms 

LCBPFORMI Punch forms 

LCBPUB I Corresponding PUB address 

LCBMSCTR I Message counter. This field contains the number of 

[messages for the user of this LCB in the remote message 

(queue. 

I 

I 

I Since this remote message queue contains 255 entries an 

I overflow condition may occur. Should an overflow occur/, 

jthe LCB with the highest value in this field is located/^ 

|?.ll messages for this user are removed from the message 

I queue and replaced by message 1R20I. 

I Not used 
X X . ^ « ^ 



120 
121 
122-123 

124 



125 



126 
127 



78 
79 

7A-7B 

7C 



7D 



7E 
7F 



LCBPROUT 
LCBLROUT 
LCBBFSI Z 

LCBPLINE 



LCBPRMT 



LCBPRLEN 



Default punch routing 

Default list routing 

Terminal buffer size 

Size of this buffer depends on type of terminal. 

Terminal type plus line features 



X'8 0' Log every channel end ^ 

X'40' Transparency ^ 

X'20' ASCII code 

X'02" 3780 

X'Ol' 2780 or 3741 

X»00* 2770 or 3780 with component select 



Terminal features 

X'20' Hardware compress feature 

X'lO' Multiple-record feature 

X'08' Horizontal format control 

X"02" Variable length records 

X'Ol' Blocked records 

Remote printer width 
Reserved 



•H 



H^ ,/ 



Figure 5.32. Line Control Block (Part 4 of 4) 

^ In PL/S listings the first characters of these labels are LC instead of LCB, 

2 The byte is set X'80' if TRACE=YES has been specified in the REMOTE macro. It enables 
a wraparound lyo trace in the phase IPW$$TM. (See Section 6 for details.) 

3 Transparency enables user to transmit object decks over line. If no transparency is 
supported codes X'OO" through X'40' are converted to binary zeros for output to the 
terminal. 



Transparency on input (read) is determined by a switch on the terminal unit. 

For print output to the terminal, non- transparency if forced by POWER/VS. 

For punch output , transparency depends on whether it has been specified in the PLINE 
macro and the PRMT macro. If either one has not been specified for transparency,, 
non- transparency is forced by POWER/VS. 
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X'lO' in this byte indicates that the command *b. -bSTOP MSG has been issued. This 
prevents system and broadcast messages from being transmitted and printed on output 
which must be free from such messages » such as salary slips. 

Messages are always queued and issued when an ACK is received from the terminal 
(PRINTER ready). The STOP MSG command causes all messages to be lost, that is, they 
are not queued. 

Messages are requeued and output as normal by issuing the command *b..bSTART MSG. See 
field LCBMSG for an explanation of message queues • 



( 
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BUFFER CONTROL AREA (BCA) 



Definition macro: IPW$DBC: 



Bytes 

T- 

Dec 1 



Hex 



I 

fLabel [Description/function of field 
of field] 



h 



RJE CCB (label BGACCB) j 

1 
Initialized with a complete sense CCW to read sense information | 
.into the. two sense bytes in the BCA. Byte 12 is initialized with ] 
bits 1 and 2 on, indicating that channel^end appendages and private] 
unit-check routines are being used* f 

. jj 



00-01 

02 

03 

04-05 

06-07 

08-11 

12 

13-15 

16-23 



00-01 
02 
03 

04-05 
06-07 
8- OB 
OC 

OD-OF 

10--17 

i— 



Residual count 
Communication byte 
Communication byte 
Status bytes from CSW 
Logical unit number 
First CCW address 
Communication byte 
Channel appendage address 
RJE sense CCW 



h 



CCBCNT i 

CCBCOMl 1 

CCBC0M2 I 

CCBSTA I 

CCBLUB ] 
lOBSTARTj 

CCBBY3 I 

CCBAPP 1 

BCACCWO 1 

RJE CCW string, dynamically set up by MCCWINIT routine 



-H 



24-31 
32-39 
40-47 
48-55 
56-63 
64-71 



18-lF 
20-27 

2 8-2F 
30-37 

3 8-3F 
40-47 



lOBCCWl 
I0~BCCW2 
I0BCCW3 
IOBCCW4 
IOBCCW5 
I0BCCW6 



I These six CCW fields constitute various channel programs 

I that depend on the operation required. 

I For example, a READ program consists of 

I • An enable CCW 

I • A write response CCW 

I » A read text CCW 

I 

I A WRITE program has a different CCW string and a PREP 
j program consisting of: 

I 

I • A disable CCW 

j • A set mode CCW 

I • An enable CCW 

!• A write enquiry CCW 

]• A read response CCW 

I 

[These CCW strings are described in Sections 2 and 3, 



EBCDIC/ASCII Code Table 

This table is moved from virtual storage at OPEN time for RDR, 
or PUN to reflect one of the following four conditions: 

EBCDIC code transparency 
EBCDIC code non-transparency 
ASCII code transparency 
ASCII code non-transparency 



LST,| 
I 



Figure 5.33« Buffer Control Area (Part 1 of 3) 



\J 
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h 



Bytes 



T- 

Dec I 



Hex 



Label of 
field 



Description/function of field 



72-73 

74-75 

76 

11 



lS-19 

80 
81 



82 
83 



84 
85 



86 
87 



90 

91-92 
|. 



h 



48- 

4A- 
4C 

4D 



-49 

-4B 



4E 
50 
51 



-4P 



52 
53 



54 
55 



56 
57 

58 
59 
5A 
5B 



-5C 



MSOHENQ 
MSTXSEQ 
METBSEQ 
MBSCETB 



METXSEQ 

MACKOSEQ 

MBSCACKO 



MACKISEQ 
MBSGACKl 



MNAKSEQ 
MBSCNAK 



MBSCACKX 

MBSCCWCH 

MBSCENQ 

MBSCEOT 

MBSCWACK 

MEOTSEQ 



Multileaving sign-on sequence 

Start of text sequence 

End of text block sequence 

End of text block character 

This 1- byte field is the second byte of the previous 

2-byte field. 

End of text sequence 

Even acknowledgement sequence 

Even acknowledgement character 

This 1-byte field is the second byte of the previous 

2-byte field. 

Odd acknowledgement sequence 

Odd acknowledgement character 

This 1-byte field is the second byte of the previous 

2-byte field. 

Negative acknowledgement sequence 

Negative acknowledgement character 

This 1-byte field is the second byte of the previous 

2-byte field. 

Acknowledgement conversion- character 

CCW chaining character 

Enquiry character 

End of transmission character 

Wait before transmit 

DLE-EOT characters 



Other RJE Information 



H 



c 



93-94 

95 

96-99 

100 

101-10 3 

104 



105-107 
108-111 



112-115 
116-119 

120-123 



124-127 

128-131 

132-135 
136-139 
140-143 



5D- 

5F 

60- 

64 

65- 

68 



69- 
6C- 



70- 
74- 

78- 



7C- 



5E 
63 
67 

6B 
6F 

73 
77 

7B 
7F 



80-83 



84- 



8C- 



87 

8B 
8F 



LCBWRCNT 

BCAUCCNT 

lOBRESTR 

TPBLCCC 

TPBLCCAD 

TPBRECNT 



TPBFDATA 



BUFEWF 



BUFDCT 
LASTCCW 

BCADISP 



BUFCHAIN 



BCATCBAD 



RLBUFAD 



TPBUFAD 



BCAFRMCB 



Saved write count 
Maximum retry count 
Restart address of channel program 
Last remote output command code 
Address of the last remote carriage control 
Current remote output record count. Incremented at each 
PUT during a WRITE operation. The count is compared with 
the value in the field TPBMXREC. If they match,, the PDA 
is written out. 

Remote data pointer. Address of the record in the PDA 
currently being processed. 

Address of last data byte read. Address of the last byte 
read into the PDA (not necessarily the last byte in the 
PDA). 

Address of the corresponding LCB 

Address of the last CCW executed plus 8 (stored by the RJE 
channel appendage routine on every I/O interrupt) . 
Displacement between the real and virtual address of the 
BCA (used to construct real addresses for the channel 
program) . 

Address of next CCB completed. BCA chain pointer, set up 
by channel appendage routine,, and processed by line 
manager. 

Address of a list TCB or punch TCB as long as an RJE LST 
or PUN task is active. Otherwise, the field is 0. (Has 
j^same function as field LCBTCBAD in the LCB. ) 
Real address of PDA. Address of current TP buffer. 
Updated whenever a new buffer is obtained. 
Virtual address of PDA. Address of current TP buffer. 
Updated whenever a new buffer is obtained. 
Address of last TCB,, as long as a form change is needed. 
Otherwise, the field is 0. 



Figure 5.33. Buffer Control Area (Part 2 of 3) 
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"" ■— '■™"— — 


"™°°*~""" 


— y«.«.«. ^ ^ y. mmmm 


Bytes 




1 1 








«» J T ;^ }~\(^ 1 0"Flrj^c!OT""iT"i+"'iori^"F nn oi" TOTSo'F'FiP*lr? 




"T 


"'"'■"" 




Dec 


1 

4- 


Hex 


1 field 1 


"' " ' ""■' 




' ' " 




1U4 


1 90 

1 

1 




1 liCBMCB 1 Remote mode byte (SDA mode byte). Set at line 

1 j initialization time to X'04' for 2701, and to X*CO' for 

1 |27 03 TP control unit or ICA. 


145 


|91 




jLCBACK [Remote next acknowledgement- For write response CCW. 


1,46-147 


|92- 

1 
1 


93 


1 LCBRGL 1 Remote response control block. Used for the write 

1 1 response to the terminal, and to read the response from 

1 |the terminal. 


148 


|94 




:] lOBSENSGI First sense byte (see TP manual) 


149 


|95 




1 lOBSENSlI second sense byte (always 0) 


150 


|96 

1 

1 




ITPBMXR EC [Maximum output record counts* Contains a value equal to 
1 |the maximum record count for the output buffer at the 
1 [terminal. Its value depends on the terminal type. 


151 


|97 

1 

1 

1 

1 




1 BCAFLAGS 1 BCA flags 

1 1 

1 (X'Ol* end of transmission 

J |X«0 2' end of forms 

1 jX'04" second entry to put routine 



\_J' 






Figure 5.33. Buffer Control Area (Part 3 of 3) 



BSC LINE - MANAGER' TCB FIELDS 



These fields replace ^he General Task Work Area, Linkage Register Save Area,, and the File 
Control Words of the TCB in case it belongs to an RJE,BSC Line Manager task. 



I Bytes I I 

j.- . ^^■. — .^^, f Label [Description/function of fields 

I Dec ] Hex [of field | 

100-27 JOO-IB I ! Reserved 

[28-31 [IC-IF [TCSR [ SYS REC header 

[32-87 [20-57 [TCLM [BSC line manager save area 

[88-103 [58-67 [ [Reserved 

L X^. ^± - X . . , 






Figure 5.34. BSC Line Manager TCB Fields 
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SNA COMPACTION TABLE CONTROL BLOCK (COCB) 



Definition macro: IPW$DCO 

I The address (COAD) in a COCB entry will be used for retrieving the FMH3,, and fetching 
the compaction table for use in the compaction algorithm. 



N- 



-32 bytes. 



00 
20 



400 



1 

COCB 


1 1 

Storage Descriptor 
1 1 


1 1 1 1 1 
CONXCONE COTG COAG Reserved 
III II 


Table Entries (16 bytes each) 



Bytes 
r — 



Dec 



Hex 



-+ — 

I 00- 
|10- 
|14- 
|16- 
|18- 
jlA- 



|2 0- 

|20- 

|24- 

|28 

|29 

I 2 A- 

I 2C- 

|2E- 



OF 
13 
15 
17 
19 
IF 

2F 



I 

[. 

I 00-15 
116-19 
I 20-21 
122-23 
I 24-25 
126-31 

F 

I 32-47 

h 

132-35 
I 36-39 
|40 
I 41 

I 42-43 
I 44-45 
146-47 

^ 4 

148-1023 I30-3FF 

U X 



I 

H Label 
I field 






of I Description/function of field 



JCOSD j Storage deccriptor (COCB) 

|C0NX [Address next COCB 

I CONE [Number of entries in COCB 

JCOIG I Maximum number of GETVIS table entries (IK each) 

I COAG I Actual number of GETVIS 

I I Reserved 



— ^ 



23 
27 



2B 
2D 
2F 



I First 

•+ 

] CONA 
I COAD 
I CO ID 
I 

jcous 

JCOLN 



Compaction Table Entry 



i Compaction table name 

1 Compaction table address 

[Compaction table identifier 

[Reserved 

I Compaction table use counter 

[Compaction table length 

[Reserved 



-H 



-+ 

[Remaining Table Entries 

-X . 



Figure 5. 3 4 A. SNA Compaction Table Control Block 
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SNA LOGON REQUEST CONTROL BLOCK (LRCB) 



Definition macro: IPW$DLR 

A logon request control block contains information for 6 logon requests to the POWER/VS 
application. All logon request control blocks are chained. The pointer to the first 
LRCB is contained in the SNA control block (SNCB) . 

Information about logon requests are stored in the LRCB by the logon exit of the SNA 
manager. The logon processor processes the logon requests to build SUCB/LUCBs. 



\.. J 



K- 



■ 32 bytes - 



nex 


1 
LRCB 


Storage 


Descriptor 


, -| -T 

LRNX Reserved 


1 

Reserved 


00 




1 


1 


I 1 


, 


20 






6LRUB'S (16byteseach) 


- 


40 


- 






- 


60 











Bytes 



I Dec 

I- 

(00-15 

116-19 

I 20-23 

I 24 

I 25 

|26 

I 27 

128-31 

\~— 

132-47 

I 32-35 
136-43 
I 44 

145-47 
h 



Hex 



48-127 



I 
-\ 

I 00-OF 
110-13 
114-17 
1 18 
I 19 
|1A 
I IB 
I IC-IF 

I20-2F 

--+ 

120-23 
I24-2B 
|2C 

I2D-2F 

-+ ^— 

I 30-7F 



--j Label of | Description/function of field 
I field I 



|LRSD j Storage descriptor (LRCB) 

I LRNX [Pointer to next LRCB 

I I Reserved 

|LRLC [Length of one LRCB 

|LRLB I Length of one LRUB 

I LRAL I No. of total LRUBS in LRCB 

I LRUS I No. of active LRUBs in LRCB 

I I Reserved 

I First LRUB entry 

I LRAC 
ILRLU 
I LRST 
I LRLM 



-H 



JACB address 

I LU- name 

I Status (X'Ol' indicates active entry) 

I Length of logon message 

»X- -. . . ^. 



\ 



j Remaining LRUB entries 

.JL . . . -.- . . .: 



\ 



Figure 5.34B. SNA Logon Request Control Block 



4' 
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SNA LOGICAL UNIT CONTROL BLOCK (LUCB) 



Definition macro: IPW$DLU 

A logical unit control bJ ock (LUCE) is created for each logical unit logon to the 
POWER/VS application. 

All logical unit control blocks within one work station are chained together. The 
pointer to the first LUCB within one work station is contained in the SUCB, which 
describes this work station. 



-32 bytes 



00 
20 
40 
60 
80 



LUCB Storage Descriptor 
1 1 1 



LUNX LUSU 
1 



LUW1 LUW2 LUCD - 



LUDY • 



LUST LUET ■ 



-+-- h 

LURI 



■Luur 



-►H 



I LUTC 
' LURT 



LULT LUMT LUT1 
1 1 



LUTH 





Bytes 


1 








>-.J T ^h^l n-F 


Description/function of field 








Dec 


1 Hex 
^i 


[field 






t 


T ■ r 


00-^15 


lOO-OF 


iLUSD 


Storage descriptor 


16-19 


110-13 


1 LUPR 


Previous address LUCB (pointer) 


20-23 


114-17 


1 LUNX 


Address of next LUCB (pointer) 


24-27 


118-lB 


|LUSU 


Address of SUCB 


28 


|1C 
1 


ILUSL 
1 


Select indicator 
C'S'-select 


29 


|1D 


ILUTT 


Termination type (C'S' - immediate) 


30 


|1E 


ILUTX 


Termination type, set by exits 


31 


|1F 
1 


1 LUFS 
1 


Free session indicator 
X"80' - session in use 


32-35 


120-23 


ILUWI 


Reader 1 work space address 


36-39 


1 24-27 


|LUW2 


Reader 2 work space address 


40-43 


I28-2B 


1 LUCD 


VTAM CID 




^ 1 ^ 


J. J- 






T*" *• "^ 






1 


(Session Accounting Information 






- -L— ^-, — ^ 






■"""i"" — — — 




44-51 


I2C-33 


ILUDY 


Date = c'MM/DD/YY' 


52-55 


134-37 


ILUST 


Signon time = X' OHHMMSSF' 


56-59 


I38-3B 


ILUET 


Signoff time = X' OHHMiyiSSF' 


60-75 


I3C-4B 


|LUUI 


User information 


76-83 


I4C-53 


|LULU 


LU name 


84-85 


154-55 


1 


Reserved 


86 


|56 


ILUAI 


c'S* - identifier for account record. 


87 


157 

1 

1 


ILUCN 

1 

1 


Session termination code 

X'Ol' - Normal (SIGNOFF or LOGOFF) 

X'0 2' - Abnormal 


88-91 


I58-5B 


ILURB 


[Remote identifier 


88 


158 


|LURB 


Binary format 


89-91 


1 59-5B 


ILURC 


[Character format 



-^ 



Figure 5.34C- SNA Logical Unit Control Block (Part 1 of 3) 
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r- 


—■"■—'——"—■— — '" 


- T^ '^ 


-T - - — 


1- 


1 Bytes 


1 


1 








«-.J T ;:^K«=i1 n^ 


E] Description/function of field 








■"•""I JLiClJLJCrX vjj 




1 Dec 


i Hex 


. 1 field 

1 


1 


^^j 




_J ■ 


— ^ 

1 Restart 


Information 


— -^ 

— ^ 


1 ■'■ '" ■"'. ' '" — "*" 


~T 


•>_ .j .._ Ill .. ». „..«». 


T""*""''*""'"'*" 


192-95 


'I5C-5F 


JLURS 


i Restart 




|92 


1 5C 


1 LURX 


j Restart function index 




193-95 


I5D-5F 

JL 


1 LURD 


1 Restart page count 


J 




"T " 






.^-^^ 






1 List and Punch Characteristics 






-+ — 


— 1_ — . — ;_. 




J 


"*"f* ""— ' ■ — — -mm-mm. .^ .«».>..« «««»ai m. jji ... x.. Ji i.u 1. . JU.. • i 1 ..Ji i u. B •■ i 1 ill I 


•^ — 1 


196-99 


160-63 


|LUPH 


i Pointer to device in SUCB 




1 100 


1 64 


ILULQ 

1 

1 

1 

1 

1 

1 

! 


1 List output support 

IX'OO' - List output support 

|X'80' - ASCII 

|X'40' - Compression 

jX'20' - Transparency 

JX'IO' - Spanning 

1X*08* - Inter-record separator 

IX' 01* - compaction 




|101 


1 65 


JLUPO 

1 

1 

1 

1 

1 

1 

1 


1 Punch output support 

jx'OO' - Punch output support 

IX' 80' - ASCII 

|X'40' - Compression 

|X'20' - Transparency 

jx'lO' - Spanning 

1X'08' - Inter-record separator 

jx'Ol' - Compaction 




|102 


1 66 


■1 LUPD 
1 


JPDIR information byte 

|X'80' ^ PDIR outbound allowed. 




1 103 


|67 


|LUAD 

1 

1 

) 

1 
1 


j Card/document flow 
[X'OO* - Card/document flow 
|X'80' - Card inbound allowed 
|X'40' - Card outbound allowed 
IX' 08* - Document inbound allowed 
|X'04' - Document outbound allowed 




1 10 4- Hi 


1 68-6F 


JLUcx: 


1 Current compaction table in use by outbound processor 




1104-107 


I68-6B 


jLUOl 


j Compaction table name 




1108-111 


I6C-6F 


1LU02 

1 . 


1 Pointer to CDCB entry 

-X «— ^.•. — •^^^ ^ ^^^^^ «. ^ ^-.«.^^ — •.^— .^— .^^-» ^«., 


.J 




^JL^«. -.. 


— i 

1 Process 
1 . 


Control Section 




I — — — '—■ T"— — — 


""t 


— t •■ 


— ^ ^— -.«_- ..^ ^«.^«. «.«.«. «.«.«.«.«. «. .— - — . . ^ ... «. «. 


""-— 1 


1 112-115 


1 70-73 


JLUTC 


[Start address of TCBs for LU 




1112-115 


17 0-73 


ILURT 


|RDR, LGN, LGF, TCB address 




1116-119 


174-77 


ILULT 


|LST,, PUN TCB address 




1120-123 


I7 8-7B 


|LUMT 


1 Message TCB address 




1 124-127 


1 7C-7F 


|LUTI 


|RDR2 TCB address 




1128-131 


180-8 3 


1 LUTH 


1 LGH TCB address 




|132 


1 84 


ILUAl 

1 

1 

1 

1 

t 

1 

1 

1 


[Action byte 

|X'80' - Request logon 

|X'40' - Request start reader 

ix'20' - Request interrupt LST/PUN on signal' 

|X'10' - Request interrupt LST/PUN for outbound message 

|X'08' - Request interrupt inbound for inbound 

|X'04' - Request stop session 

iX'02' - Request GO/SETUP command 

jx'Ol' - Request for restart command 




|133 


1 85 


ILUPl 
1 


1 Process byte 

JX'SO'^ - Logoff in process 





V:,y 



v y 



--.J 



Figure 5.34C. SNA Logical Unit Control Block (Part 2 of 3) 
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( 



r 






-"^■^ ■*-""" 


— T 


"'*"■"' "f "" ""~"~' ' "" ---■--•---•■—■--■--■-■— — — ™ "■■■■■'"—•——— — — — -»-~— — '——•—•••'' — — " ■ ' '■" HI —•"» — •■— < 


" "^ ■*" ~ "~ ""■ "^^ "^ *" *- "" 


i 


Bytes 






1 




J ^, 








J T raKol 


of ] Description/function of field 






" """"■""*"" 


•T 


* ■^ —■ "" "" 


-■ — -^ JLiclJJcrX 




1 Dec 


1 


Hex 


Ifield 


1 




1 




_j. 




1 


.^ X « ^^ «. ^ « «. ^« -.^— ^ -» 




r 




1 




-J - 


^ ^ _ ^ « -« 




1 134 
1 

1 
1 
1 




1 86 

1 

1 

1 

1 




1 LUSl 


(Status byte one 

JX'SO' - BB reject indicator 

jx'ao' - Logon completed 

|X'01' - 1 - BB reject by IPW$$OB 

1 C -" BB reject by IPW$$MP 




|135 

1 

1 

1 

I 




187 

1 
1 
i 
1 




ILUS2 


1 Status byte two 

|X'80' - Change direction 

|X'4 0* - LST/PUN suspended for msg 

|X*20* - LST/PUN suspended for inbound 

JX^'IO' - Inbound suspended for inbound 




|136 




|88 




|LUBR 


] Bracket state 




1137 




1 89 






j Unused 




|138- 


-139 


|8A- 


-8B 


ILUBS 


1 Buffer size 




1 lao- 


■mi 


1 8C- 


-8D 


1 LUBSL 


1 Buffer size logon process 




|ia2- 


-159 


|8E- 


-9F 




j Unused 





Figure 5.34C- SNA Logical Unit Control Block (Part 3 of 3) 
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SNA REMOTE CONTROL BLOCK CRMCB) 



Definition macro : 



IPW$DR]yi 



c 



y 



The SNA remote control block consists of: 

• General information that is not required in real storage for RJE, SNA processing 

• A general work space to be used by any SNA routine that cannot obtain virtual storage 
via the DOS/VS GETVIS macro 

• Translate tables to convert EBCDIC characters to ASCII and vice versa 

• Remote entries for each remote ID specified in the PRMT macro at DOS/VS POWER/VS 
generation. 



Bytes 



Dec 



I 



EBK 



00-15 lOO-OF 
16-19 110-13 
20-22 114-16 
23 1 17 
2U-31 I 18- IF 
„ 1. ^. 

32-1055 I20-41F 
I 



I 



Label of 
field 



RMSD 



RMAL 
RMAP 



^ „„ 

Storage descriptor (RMCB) 

Reserved 

Reserved , 

Length of ACB password 

ACB password 



Description/function of field 



-H 



RMGP 



General purpose work space 

This area is serially accessible by SNA tasks that cannot 
obtain virtual storage via the DOS/VS GETVIS macro- 
Access is regulated by a lockword (SNRL) located in the 
SNA control bl6ck (SNCB). 



1056-13111 420-51F 
1312-1439 I 520-59F 



RMEA 
RMAE 
+ 



Translate table to convert EBCDIC characters to ASCII 
Translate table to convert ASCII characters to EBCDIC 



^-+— 



h 



SNA Manager save area 



1 
-1 



1440-1567 15A0-61F 
1440-14471 5A0-5A7 
1448-1567 I 5A8-61F 
1568-16391 620-667 
1640-1711 I668-6AF 



RMSNSS 
RMSNSN 
RMSNSR 
RMSNRA 
RMSNST 



Subtask save area 

C •IPW$$SNV - Subtask name 

Register save area 

VTAM RECEIVE Any save area 

VTAM SETLOGON save area 



-H 



1712 
1713 
1714 
1715 



h 



|6B0 
16B1 
1 6B2 
|6B3 
I , 

-+ - 

16B4- 



RMSR 
RMFR 
RMHR 
RMNC 



No. of SNA remote entries 

First SNA remote ID 

Last SNA remote ID 

Total no. of IK blocks in GETVIS pool for compaction 

tables including COCB. 



-1 
6| 



1716- 



RMRM 



r 



Remote entries (The number of remote entries, which are 1 
bytes long,j, depends on the number of SNA remote units 
specified in the PRMT macro at POWER/VS generation*) 



— J 



Figure 5.3 5. SNA Remote Control Block (Part 1 of 2) 
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c 



The following is a layout of a remote entry 



Dec 



Bytes 



Hex 



Label of 
field 



RMPR 
RMLR 
RMRI 
RMBS 
RMTT 
RMTF 
RMCS 



RMPL 
RMPW 
RMCN 
RMNL 
RMLA 
RMSL 



Description/function of field 






Punch routing remote ID (1 byte) 

List routing remote ID (1 byte) 

Remote reference information 

Buffer size (1 byte) 

Terminal type (1 byte) 

Terminal features (1 byte) 

Console specified (1 bit) 

Reserved (7 bits). 

Reserved (1 byte) 

Length of password (1 byte) 

Password (8 bytes) 

Compaction table name (4 bytes) 

NumiDer of LU names (1 byte) 

Address of first LU name in list (3 bytes) 

Session limit C2 bytes) 

Reserved (6 bytes) 



Figure 5.35. SNA Remote Control Block (/art 2 of 2) 



How to Locate 



Refer to Figure 6.1 in Section 6, 



( 
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SNA CONTROL BLOCK (SNCB) 



Definition macro: IPW$DSN 



V^/ 



The SNA control " block contains general information that is required in real storage for 
RJE^SNA processing. 



r 




T - ~ T ' ~ - ' 


L ^ 




Bytes 


Label of 
field 


Description/function of field 


r 


Dec 


J. 

1 Hex 


1 


* — ~ 


— X. 




^ -»«-«. «»«. — «^ —- .^-^-„«.« «._ -^— ^-— ^-„-.— -.^^^««. 


r 




'~"~'T'~ """ "^^ 





.-> — ^ 


1 00- 


•15 


1 0- OF 


SNSD 


Storage descriptor (SNCE) 


|16 




]10 


SNTT 


SNA termination type 


1 17 




111 


SNTX 


Termination type set by SNA exit routines 


|18 




|12 
1 


SI^FL 

1 


Flag byte: 

X'80' - SNA stop requested (SNSS) 
X'40' - Kill SNA requested (SNKS) 
X'20' - Subtask detach requested CSNST) 
X'lO' - Subtask quiesce requested (SNRQ) 


|19 




113 


SNSU 


Maximum number of logical units 


|20- 


■23 


114-17 


SNFS 


Address of first active, SNA unit control block (SUCB) 


|2a- 


-27 


]i8-lB 


SNSP - 


Address of SNA unit control block space 


|28- 


•31 


IIC-IF 


SNLW 


SNA control block lockword 


|32- 


-35 


120-23 


SNRM 


Address of SNA remote control block (RMCB) 


136-39 


1 24-27 


SNRL 


Lockword for general purpose work space (RMGP) in SNA 










remote control block 


1 UO- 


•U3 


I2 8-2B 


SNTC 


Address of SNA manager TCB 






I2C-2F 


SNSB 


Subtask ECB 






1 30-33 


SNEB 


SNA manager work ECB 






130-31 




Unused 






|32 




Post byte 






|33 




Unused 






I34-3B 




Reserved 






1 3G-7B 


SNAC 


VTAM ACB + 4 words for expansion 






I7C-7F 


SNSL 


Pointer to logon space pool for SUCB/LUCB, WACB and LRCBs 






180-83 


SNCP 


Compaction table pool address 






184-87 


SNCR 


Address first logon request control block (LRCB) 






1 88-8B 


SNWS 


Address logon SUCB 






18C-8F 


SNCA- 


Address of compaction table 






1 90-93 


SNEC 


LRCi chain - lockword 1 






194-97 


ISNFC 


LRCB chain - lockword 2 






1 98-9B, 


SNCL 


Compaction table lockword 






19C 


, 


IPW$$LH process oyte 

X*80' - Request for IPW$$LH 

X*40' - IPW$$LH is active 






1 9D-B7 




Unused 



H 



I ^Figure 5.36. SNA Control Block 



How to Locate 



Refer to Figure 6.1 in Section 6. 
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SNA UNIT CONTROL BLOCK (SUCB) 



Definition macro: IPW$DSU 



An SNA unit control block is created for each logical unit loggeci on to the POWER/VS 
application- All SNA unit control blocks are chained together. 



T 





Bytes 


1 


j Description/function of field 




Dec 


^ 

1 Hex 


1 field 




0-15 
16-19 


lOO-OF 
1 10-13 


-+ 

ISUSD 
ISUNX 


1 Storage descriptor (SUCB) 
I Address of next SUCB 






1 


1 


1 General Accounting Information 




20-31 


114-lF 


-+ 

1 SUAR 


1 General Information 


— — ^-~— 


20-27 


114-lB 


ISUDY 


iDate = C'MM/DD/YY' 




28-31 


IIO-IF 


1 SURI 


I Remote Identifier 




28 
29-31 


lie 

IID-IF 


jSURB 
ISURC 

1 , 


j- Binary format 
j- Character format 






1 

J. 


— -j. — 

1 
J 


|List, Punch and Reader Device Characteristics 




32 
33 


|20 

121 

1 

1 

1 

1 

1 

1 

j 


ISULP 

ISUPP 

1 

1 

1 

1 

1 

1 

1 


JList routing remid 
1 Punch routing remid 

1 Device status values for the following devices: 

|X'8 0" - Device started 
|X'40" - Device available 
|X'20' - Output available 




36-39 


124-27 


1 

1 SULIP 


1 Printer 1 - C'LSTl' 




40 


|28 


JSULIS 


I Device status 




41-43 


I29-2B 


1 SULIL 


1 Pointer to LUCB 




44-47 


I2C-2F 


1 SULIF 


[Forms ID 




48-51 


130-33 
1 


ISULIC 
1 


|List output classes 




52-55 


134-37 


1 

1SUL2P 


[Printer 2 - C'LST2' 




56 


|38 


ISUL2S 


[Device status 




57-59 


I39-3B 


1 SUL2L 


[Pointer to LUCB 




60-63 


I30-3F 


1 SUL2F 


1 Forms ID 




64-67 


140-43 
1 


1 SUL2C 
1 


[List output classes 




68-71 


1 

144-47 


1 
ISUL3P 


[Printer 3 - C'LST3" 




72 


|48 


1 SUL3S 


[Device status 




73-75 


I49-4B 


1SUL3L 


[Pointer to LUCB 




76-79 


1 40-4F 


1 SUL3F 


1 Forms ID 




80-83 


150-53 
1 


isUL3C 
1 


JList output classes 




84-87 


154-57 


1 

1 SUPIP 


[Punch - C'PUNl' 




88 


|58 


ISUPIS 


(Device status 




89-91 


I59-5B 


ISUPIL 


[Pointer to LUCB 




92-95 


I5C-5F 


1 SUPIF 


1 Forms ID 




96-99 


160-63 


1 SUPIC 


1 Punch output classes 








C 



L X i X . . . , J 



Figure 5,37. SNA Unit Control Block (Part 1 of 2) 
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Bytes 



Dec 



I 



Hex 



I 
-| Label of 
I field 



1100-103 
I 104 

1105-107 
! 108-111 
1112-115 



1116-119 
1120 
1 121 
1124 
1128 



123 
127 
131 



I 

|132 

I 133-134 

1135 

1136 

il36 

1 14 

1144 



143 
139 
143 



164-67 
|68 

169-6B 
1 6C-6F 
170-73 

1 

174-77 

|78 

179-7B 

17C-7F 

180-83 

! 

184 

1 85-86 

187 

1 88-8F 

188-8B 

j 8C-8F 

I 90 

1 

1 



1 SURIP 
i SURIS 
I SURIL 
I SURIF 
1 SURIC 

i 

1 SUCIP 

1 SUCIS 

I SUCIL 

1 SUCIC 

JSUCIC 

! 

I SUHD 

1 

I SUDLS 
|SUOC 

isuoi 

1SU02 
ISUAD 






1145 



I 91 



1146-148 

1149 

1150-151 

1152 

1153 

1154 

I 155 



K — 

I 

I- 

1156-159 
1160-163 
1164 
1X65-167 

1 

1168-171 
1172-173 
1174-175 
1176-191 



! 

I 

1 92-94 

195 

196-97 

198 

199 

19A 

I 9B 

! 
-+ 



1 SUMR 



I 

1 SUMRL 

i 

iSUMN 
JSUMC 
JSUMD 
1 SUTY 
JSUTF 

! 



--+ 



-f 

19C-9F 
|A0-A3 
1A4 
1A5-A7 

I 

1A8-AB 
lAC-AD 
1 AE-AF 
IBO-BF 



Description/function of field 



V jy 



Reader - C'RDRl' 
Device status 
Pointer to LUCB 
Forms ID 
Reader classes 

Console - C'CONl' 
Device status 
Pointer to LUGB 
Forms ID 
Console classes 

Device List delimiter 

Reserved 

Device select indicator 

Default compaction table for outbound 

Name of default table 

Address of default table virtual 

Card/docToment flow 

X'80' - Card inbound allowed 

X*40' - Card outbound allowed 

X'08' - Docament inbound allowed 

X'04' - Document outbound allowed 

Message Control Section 



~! 



"H 



H 



Message request status j 

X'80' - Message processor for work station is active j 
X'40* - Request to interrupt IPW$$OB for outbound message j 

was issued j 

1 

Pointer to the LUCB with the suspending IPW$$OB | 

Unused ] 

No, of messages 1 

Subchain index 1 

Temporary delete chain index ] 

Terminal type ] 

Terminal features j 

X'80' - Console specified } 



Miscellaneous 



I SUWLW 
j SUWl 

I 

I SUWSL 



I 



ISUPL 

1 SUNl 

SUN2 



Address of work station lockword 

Inbound work space address 

Reserved 

Pointer to LUCB. If set then workspace i^ in use by the 

LUCB being pointed to. 

Pointer to first LUCB 

No. of attached LUCBs 

No. of active LUCBs 

Unused 



— J 



Figure 5.37. SNA Unit Control Block (Part 2 of 2) 



How to Locate 



Refer to Figure 6.1 in Section 6. 
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SNA WORK AREA (WACB) 



Definition macro: IPW$DWA 



This work space is reserved for and used by each logical unit processing routine (RDR^ 
LST, PUN., and MSG) . 



r 

1 ] 


Bytes 




j 


T 




L 






1 T ^H^l 


of 1 Description/function of field 


r 


.y 


"*-"-~ ~ '■"■ 


-— -^ JjdJJcx 


1 Dec 


i 

J 


Hex 


1 field 


1 










f 


.-.«-^ ^— — .^— , 


— "*" — — —— ' — "~ — '"- -~— — . ^ — . 








JWALN 


1 Fixed part of SNA work space 


100-15 


10 0- 


-OF 


jWASD 


1 Storage 


descriptor (WACB) 








IWABC 


1 Buffer control fields 


116-19 


110- 


-13 


iWARC 


1 Residual count in buffer 


1 20-23 


jia- 


-17 


1 WACR 


1 Current 


position in buffer 


124-27 


118- 


-IB 


JWABI 


! Address 


of buffer to SEND/RECEIVE 


! 28-31 


jlC- 


•IF 


JWABP 


[Address 


of buffer in process (FILL) 


132-35 


120- 


-23 


JWARL 


1 Logical 


record length 


136-171 


124-AB 


JWALR 


] Logical 


record 


|172 


1 AC 




1 WASW 


1 Process 
!X'02' - 
IX'OI' - 

1 As used 


ing switches: 
End of file 
Logical interface open (WALI) 

by SNA inbound processor: 




IX'80* - 


Processing console (WAIC) 










JX'40' - 


Processing reader (WAIR) 










1X«20' - 


Unconditional end bracket (WAUB) 










IX'IO' - 


Immediate termination required (WATI) 










jX'08' - 


Resume data stream state requested CWASR) . A 










1 resume FMH was received. 










1 As used 


by SNA outbound processor: 










IX'80' - 


EOF reached (WAOF) 










!X'40' - 


EOJ or chain reached (WAOJ) 










!X'20' - 


End of logical record reached (WAOL) 










IX'IO' - 


End of RU reached (WAOR) 










!X'08' - 


SETUP/GO in progress 










ix'oa' - 


FMH3 send indicator 










. 1 As used 


by SNA message processor: 




IX' 20* - 


Component not available (WAMC) 










IX'IO' - 


End of RU reached (WAMR) 



1^ Figure 5.3 8., SNA Work Area (Part 1 of 3) 



C 
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r ■ 




"I"— ««•—■»• — »- —qp >" ——»«.— —— »l. tn- •• — ■». - 1.1 at a. I I . . ..• 




1 Bytes 




! 




1 




-Jj Label of 


Description/function of field 




r 


— ^^ 




i Dec 

L« . 


1 Hex 

_ J 


1 f ielca 

1 


L ^ «.. ^ «.-«-. -. ^ ^-. 




r ^ 


-f- 


-.-j. 4 


|. -. 




1 173 


IAD 


1 WAST 


Status byte 




!174 


jAE 


1 WASS 
! WASF 

1 

i 

il 


Data stream state byte: 
jData stream state flags: 

I 
X«80' - Between c3ata stream (WASB) 

iX'40' - In data stream (WASI) 
X'20' - Enca of data stream pending (WASE) 
X'lO' - Data stream abort (WASA) 




117 5 


lAF 


IWACS 
] WACF 

1 

i 
] 

1 


1 

Chain state byte: 
Chain state flags: 

X'80' - Between chain (WACB) 
X*40' - In chain (WACI) 
X'20' - End of chain pending (WACL) 
X'lO' - End of file (WACE) 




1176 


IBO 


|WAPR 

! 
i 

j 
j 


Processing options: 

1 

X'80* - ASCII (WAAS) 

X'4 0' - Compression (WACM) 

X'20' - Transparency (WATR) 

X'lO' - Spanning (WASP) 

X'08* - Inter-record separator (WARS) 

X'Ol' - Compaction support 




|177 


|B1 


IWACI 

1 
i 

1 

] 


[Compaction indicator 

X"40' - Compaction table found 

X'80' - Indicates use count increased 




S 178-179 


1B2-B3 




Reserved 




1180-183 


1B4-B7 


jWAPH 


Save area for LUPH^ used by interrupting 


processors 


1184-187 


I B8-BB 


JWASN 


Error sense bytes 




1188 


IBC 


jWAMN 


Error message number 




1189-191 


1 BD-BF 




Reserved 




119 2-19 5 


1C0-C3 


IWAER 


Error routine address 




1 196-307 


1C4-133 


1 WARP 


RPL (plus 12 bytes for expansion.) 




1308-379 


1134-17B 


! WASV 


Register save area 




1 380-491 


I17C-1EB 


IWADA 


PL/S dynamic area 




1492-503 


!1EC-1F7 


j 


Reserved 





I Figure 5.3 8. SNA Work Area (Part 2 of 3) 
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( 







_^ — J. 






Bytes 


1 ! 










-^ Label of 


Description/function of field 




P 


j Dec 


1 Hex 


1 field ■; 

-+ ^ 


••»—<»•»■—■—•— «.———»..——■- 




1504-511 I1F8--1FF 


JWAFM 

1 ! 


Function management header (plus 2 bytes for expansion) 


i 504 


i 
!1F8 


1 1 

1 FMHLN 


FMH length byte 


|505 


|1F9 


1 FMHTYP 


FMH type byte 








1 


X'80' - Concatenation 






! 


B* 00111111' - 


FMH type 1 


1 506 


i IFA 


1 FMHSEL 


FMH select byte 






1 


B'lOOOOOOO' - 


Demand select 








B'OlllOOOO' - 


Device select 






!■ 


B'OOOOOOOO' - 


Console 






j 


B'OOIOOOOO' - 


Card reader 






1 


B'OOllOOOO' - 


Printer 






1 
1 


B'OOOOllll' - 


Logical address 


1 507 


1 IFB 


IFMHFLAG 

1 ! 


FMH flag byte 


- FMHl ADS sent on inbound data error 






i i 


X'80' - ADS send by receiver 


1 508 


jlFC 


IFMHPROP 


FMH properties byte 






1 


B'lllOOOOO' • 


Data stream state 






1 


B'OOOOOOOO' - 


Data stream resume 








B'OOIOOOOO' - 


Data stream end 






1 


B'OIOOOOOO' - 


Data stream begin 








jB' 01100000' - 


Data stream begin and end 








B' 10000000' - 


Data stream interrupt 








IB'IOIOOOOO' - 


Data stream abort 








B' 00011111' - 


Data stream characteristics 








IB'OOOIOOOO' - 


Basic exchange 








B'OOOOOlOO' - 


Compression 








IB'OOOOOOIO' - 


Compaction 


1 509 


1 IFD 


IFMHERCL 


|FMH basic exchange length byte 



j. ^™^ + 4 ^ 

1512-1023 J200-3FF jWABF ] Two SNA buffers ] 

L i J. X J 



I' Figure 5.38. SNA Work Area (Part 3 of 3) 



How to Locate 



Refer to Figure 6-1 in Section 6. 
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SNA MESSAGE CONTROL BLOCK (MSCB) 



Definition macro: IPW$DMS 



J 



The SNA message control block controls all access to the remote -message queue. The 
block is created by the DOS/VS POWER/VS initialization routine CIPW$$IR) if RJE 
processing CBSC and/or SNA) has been specified in the POWER/VS generation macros. 



h 



1- 

1 00- 
|16- 

! 2 a 

125 

126- 

128- 

I 
|32- 

i 36- 
|40- 
I 44- 
J48- 
I 52- 
156^ 
I 60- 
164- 
1 68- 
172- 
l 76- 
!80« 
L 



Bytes 

._ — . — _^ 

Dec j Hex 



15 
•23 



•27 
►31 

•35 
•39 
-43 
•47 
-51 
•55 
-59 
•63 
-67 
-71 
-75 
•79 
•87 



00- OF 
j 10-17 
118 
119 

JIA-IB 
IIC-IF 

1 

j 20-23 
124-27 
128-2B 
! 2C-2F 
130-33 
134-37 
138-3B 
I 3C-3F 
140-43 
1 44-47 
148-4B 
1 4C-4F 
150-57 



••~-^ Label 
! field 

IMSSD 
JMSWW 
1 MSFC 
JMSFI 

1 

JMSLW 
1 MSSV 
1 MSRE 
JMSRF 
i MSRO 
I MSRl 
I MSR2 
I MSR3 
}MSR4 
|MSR5 
tMSR6 
I MSR7 
1 MSR8 
1 MSR9 



of j Description/function of field 



1 Storage descriptor CMSCB) 
I Work area 
jFree chain index 
j Function indicator 
[Reserved 
I Lockword 

[Register save area 
j Register 14 
1 Register 15 
Register 

1 

2 

3 

4 

5 

6 

7 



-1 



Figure 5,3 9. SNA 



X 

Message 



[Register 
] Register 
1 Register 
[Register 
I Register 
[Register 
[Register 
[Register 8 
[Register 9 
[Reserved 
X 

Control Block 



— J 



How to Locate 



Refer to Figure 6.1 in Section 6. 



SNA MANAGER TCB FIELDS 



These fields replace the General Task Work Area^ Linkage Register Save Area, and the 
File Control Words of the TCB in case it belongs to an SNA manager task. 



J... _ ^ ^« . . . . ^ 

[ Bytes ! I I 

[ — « ^^^ ,^ j| Label of | Description/function of field ] 

I Dec 1 Hex ] field | } 

^ .^ + 4 ^ ^ ^ 

I [ JTCEL [Wait ECB list j 

[00-03 [00-03 jTCEl ] Receive any ECB address 1 

j 04-07 [04-07 1TCE2 jWork ECB address [ 

[08 [08 [TCED [End of list CX'FF') j 

[09-15 ]09-0F 1 i Reserved | 

116-19 [10-13 ITCSU j Address of SNA unit control block (SUCB) | 

1 20-23 [14-17 [TCWA [Address of SNA work area CWACB) [ 

124-27 (18-lB |TC13 [Save area for register 13 [ 

128-31 [IC-IF 1 [Reserved [ 

t : X^~ X .^. X . . : . 1 

Figure 5,«40. SNA Manager TCB Fields 



4"' 
'1 
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POWER/VS GENERATION TABLE (GNB) 



Definition macro: IPW$DGN 

The load routine required to load IPW$$I1 and a generation table with POWER/VS default 
options are supplied to the user cataloged on CIL together with all POWER/VS phases- 
Should the user require other than default options/, a new generation table must be 
assembled, and cataloged to CIL. (Refer to Appendix B* ) 



( 



h 



00-15 
16-19 
20-21 
22-23 
24 
25 
26 
27 
28 
29 
30 
31 
j. 






Bytes 



Dec 



I 



Hex 



00-OF 
10-13 
14-15 
16-17 
18 
19 
lA 
IB 
IC 
ID 
IE 
IF 
~+ 



^ Label j Description/function of fields 
of field] 

+ 



32 



33 

35 

36-39 

40-43 

44-47 



h 



48-50 

51 

52-55 

56-59 

60-63 

64-71 

72-79 

F 



|. 

72-75 

76-79 



20 



GNSD I Storage descriptor (GNB) 

GNDB JDBLK value 

GNTR ] Track group value 

GNTL [Table length plus BSC 

GNSL I Sublibrary 

GNJA [Account switch ^ 

GNPP I Pause punch switch 

GNLG I Log option ^ 

GNPY I Default priority 

GNNL [Number of BSC lines 

GNNR 1 Number of BSC remotes 

GNSP j Spool management specification 

Master List Values (referred to by label GNLV) 



21 
23 

24-27 

28-2B 

I 2C-2F 



30-32 
33 

34-37 
38-3B 
3C-3F 
40-47 
48-4F 
f 



+ 

48-4B 
I 4C-4F 



^ 



-H 



GNOP 1 Option byte 

|X'80' Clear printer at EOF (see POWER macro) 

|X*40' Mark form option for separator pages (see POWER 

macro) 
lx'20' No separator pages/cards between copies (see 
I POWER macro) 

- Feed for 3540 (see POWER macro) 

- Channel 12 multiple (see POWER macro) 



IX'Ol" 

1X'02« 
None I Reserved 
GNJL jJSEP list 
GNLl ISTDLINE first 
GNL2 JSTDLINE second 
GNRL JRBS list 
I ± 

Master Punch Values (referred to by label GNPV) 

— ^ . 

None [Reserved 

GNJP [JSEP punch 

GNCl [STDCARD first 

GNC2 [STDCARD second 

GNRP jRBS punch 

GNRE JRDREXIT name 

GNIN |IPW$$I1 phase name 

During initialization the IPW$$I1 phase name is overlaid by the 
following fields: 

GNRM I Address of remote control block (RMCB) 
GNSS (Address of SNA unit control block (SUCB) 



Figure 5.41. Generation Table (Part 1 of 2) 
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Dec 



Bytes 

I 



Hex 



T T 

-^Label IDescription/ftanction of fields 
I of fieldl 



I GNLT 
IGNLU 



I 



+— 



80-92 
93-95 



I50-5C 
i 5D-5F 



I LTAB 

I Length of LU table* 

Ixnacro, 



Accumulated length of LU= in PRMT 




96-97 

98 

99 

100-107 

108 

109 

110 

111 

112 

113-120 

121-127 



160-61 

I 62 

|63 

1 64-6B 

|6C 

|6D 

|6E 

|6F 

|70 

171-78 

|79-7F 



[Table length plus BSC plus SNA 

[Reserved 

[Length of ACB password 

|ACB password 

I Maximum number of SNA logical units ^ 

I Number of SNA remotes 

[First SNA remote ID 

[Last SNA remote ID 

I Length of APPLID for VTAM 

lAPPLID for VTAM 

[Reserved 

Variable (depending on | BSC line table entries of 12 bytes each 
niomber of lines (GNNL)) \ 

Variable (depending on |BSC remote block entries of 8 bytes each 
number of remotes (GNNR)) | 

Variable (depending on | SNA remote block entries of 20 bytes each 
number of SNA remotes | 
(GNSR)) I 



1 GNTT 

I None 

IGNAL 

JGNAP 

I GNSU 

I GNSR 

I GNFR 

IGNHR 

JGNVA 

I 

I 



-1 



-H 



-i 






^ This byte contains a single alphabetic character; the character 'A* indicates that 
POWER/VS job accounting is required; a blank character indicates that PCWER/VS 
accounting is not required. 

^ LOG Option. This byte contains a single alphabetic character; the character 'L' 
indicates that the JECL job statement is to be logged; a blank character indicates 
the opposite. 

3 GNSU will be overlaid by GNSR during initialization if the number of SNA remotes is 
smaller than the maximum number of SNA logical units. 



Figure 5.41. Generation Table (Part 2 of 2) 
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COMMAND CONTROL BLOCK (CCB) 



Definition macro: IPW$DCB 



r 


"—'—"——"" 


—T"" """*"*"""■ 


T •" 


^ 


1 Bytes 


1 




1 




L ««.«»«»^ «.«.«». 




— 1 Label 




1 Description/function of field 






T " "" 




1 ^^^ 

h 

100-01 


1 Hex 

-+ 

100-01 


|of field 1 
I 1 


\ 


ICBCT 




i Residual coimt 


|02 


|02 


ICBCI 




[First communication byte (see flags A) 




|03 


|03 


1CBC2 




1 Second communication byte (see flags B) 




|0U 


|04 


JCBSD 




[Device status byte (see flags C) 




|05 


105 


ICBSC 




[Channel status byte 




1 06 


|06 


|CBLC 




[LUB class (see flags D) 




|07 


107 


ICBLN 




|LUB number within class 




1 08 


|08 


ICBLI 




[LIOCS communication byte 




109-11 


109-OB 


ICBCA 




[ CCW address 




|12 


|0C 


ICBPI 




[PIOCS communication byte 




113-15 


lOD-OF 


ICBCS 




[CCW address in CSW 




|16 


110 


|CBNX 




[First entry outside CCB 




L 


-JL.---. -- -- 


.~JL^— .— — 




1 


— 4 


1 Flags A 


WDE 


X'OU* 


= 


wait for device end 


1 


1 


AUIO 


X'lO' 


= 


accept unrecoverable I/O error 




1 


UIO 


X'20« 


= 


unrecoverable I/O error 




1 


RODC 


X'08' 


= 


return on data check 




1 Flags B 


CCR 


X'Ol' 


= 


command chain retry option 




1 

1 


CHN9 


X'02' 


= 


channel 9 overflow 




1 

|Flag C 


UE 


x-or 


= 


unit exception 




1 
1 


UNCK 


X'02' 


= 


unit check 




1 

[Flags D 


EXR 


X'80' 


= 


EXCP real 




! 


PRU 


x'or 


= 


programmer unit 





Figure 5.42. Command control Block 



CHANNEL COMMAND WORD (CCW) 



Definition macro: IPW$DCW 



Bytes 



Dec 



[00 
01 
[04 
I 05 
[06 

|F1 



I 



Hex 



.^ ^ 

) I 

--I Label [Description/function of field 

[of field[ 



[ 01-03 

-07 
ags 



[00 

[01-03 
[04 
[05 

[06-07 
.J 

NOP 

CC 

SLI 



[CWCC 

[CWDA 
[CWFL 
[CWRE 
[CWCT 



X- 



j Command code 

[Data address 

[Chain byte (see flags below) 

[ Reserved 

[Data length field 



X'03'* = NOP command 

X' 40 • =' command chaining 

X'20' = suppress incorrect length 



J 



Figure 5,. 43i. Channel Command Word 
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SEPARATOR LINE AREA (SLA) 



■^J^ 



DSECTname : 



LWSL 



The separator line area is used to produce separator pages and separator cards in list 
and punch writer output, by the logical writer IPW$$LW. 



1 " 




1 


|. , 


1 Byt 


.es 


Label 


Description/function of fields 


1 ^- 


T 




1 Dec 


1 
i 


Hex 


of field 

u — —. — — — _. — _. 




1 


T 







. 


1 00-119 




00-77 


LWPL 


Print line 


1 120-239 




78-EF 


LWSL 


Separator line 


[ 120-142 




78-8E 


LWSO 


Line delimiter. Contains all asterisks. 


1 143-150 




8F-96 


LWS1 


START/END separator 


1 151-161 




97-A1 


LWS2 


Job name 


] 162-169 




A2-A9 


LWS3 


Job number 


1 170-177 




AA-B1 


LWS4 


Job suffix number 


1 178-196 




B2-C4 


LWS5 


User information 


[ 197-208 




C5-D0 


LWS6 


Date 


209-219 




D1-DB 


LWS7 


Time 


1 220-239 




DC-EF 


LWS8 


Line delimiter. Contains all asterisks. 


•240-247 




F0-F7 


LWCD 


Double word for convert 


248-255 




F8-FF 


LWSR 


Save area for request word 


1 256-259 




100-103 


LWSA 


Start address 


1 260-267 




104-10B 


LWJN 


Work area 


I 268 




IOC 


LWFL 


Filler 


1 269-271 




10D-10F 


LWTC 


Save area, for restart information 



Figure 5.44. Separator Line Area 

How to Locate 

This area is placed at the virtual data area address in the TCB. 



/f^ 



\^ 
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OPEN 3540 DISKETTE WORK SPACE 



DSECTname: 



OEWS 



( 



r 




~T 


^ ^ « 


1 Bytes 


1 


! 


L 




H Label 


1 Description/function of field 


r 


-.^ 


1 Dec 


1 Hex 


Jof fie 


Idl 


F 


-+ 


-+ 


.^+ « 


i 00-15 

F 

1 


1 00-OF 
-+ 

! 


1 

jOECB 


1 Storage descriptor C'OEWS V7iyi0 cuuM 

-L 


j. _ « _ _ «. _ 

1 3540 command control block 


116-17 


110-11 


|OECT 


1 Residual count 


118-19 


112-13 


jOECM 


I Communications bytes 


1 20-21 


114-15 


lOEST 


1 Device status 


122-23 


116-17 


lOELU 


1 Device type and logical unit 


|24 


118 


1 


1 Reserved for LIOCS 


j 25-27 


119-lB 


1 OECA 


1 First CCW 


|28 


lie 


1 


1 Reserved for PIOCS 


129-31 


IID-IF 


lOECW 


|CCW address in CSW 


F 


-+ 


-f 


X — 


X 


132-87 

! 


120-57 
1 


JOESV 
1 


1 Temporary register save area for the interface between 
1 functions 


F- ^~ 


L^ ^ ^ 




1 




"~" T'~"*" '~"~"~' "* 


——y— —•———■— — — " — —— — — — — .— —.——.-«.-.—. -li- -— .— -»^— -«..«. ^«- «.«.-.— «..«.« «.^«.^»»«» 


1 88-95 

L 


158-5F 

_j 


JOECV 
_x 


1 Conversion work space 


r 


T 


T 




1 


■s 


lOECP 


13540 channel program 


196-103 


160-67 


lOEDO 


1 Define operations or NOP 


|Xoa-iii 


I68-6F 


jOESK 


1 seek 


1112-119 


170-77 


|OERD 


iRead label 


1120-123 


I78-7B 


JOESM 


JMode setting argument 


1124-127 


1 7C-7F 


1 OESA 


jseek argument COOCCHHRR) 


1- 


X— . 


1 


1 


—"j"^ —"——"*" ■•-'•«• 


t 


— "—| —— — —'*"■— —*—— — '~*— "——— -I. ■« ». «- — .... — .-tni. •.. 1... ,, ».j w rii »«. «. UL n n .m ..i m. ,.. .. „. ij. .,., , „i ,,..., .i _■ ».. ,m, m, ... i>. ni . 


1128-207 
1 


180-CF 

! 

^X_ ; 


|OELB 

i 

1 


13540 input area and label test area (see Figures 5,46 and 
|5.47) 


r 


^^ 


— j. 


1 — '"" ' m, m ,t ...„«., UM. m^ ^ nM. m dpi. ■ ... ■ m, i. ii ii u l.. nu ... i... . 


1 

F 

1208 


1 

IDO 


! 
-+ 

1 OMLl 


1 Message buffers and work areas 


1 Message length of first line 


1 


1 


lOMSl 


1 First line of message output area 


} 209-215 


1D1-D7 


lOMTl 


i Message identity 


1216-263 


1D8-107 


lOMTl 


[Message text of first line 


|26a 


1108 


10ML2 


1 Message length of second line 


! 


1 


I0MS2 


1 Second line of message output area 


|265 


|109 


10MI2 


1 Message identity 


1266-319 


I110-13F 


1 0MT2 


[Message text of second line 


j320 


1140 


1 


JNot used 


1 321 


1141 


|OERL 


1 Reply length 


1322-327 


1142-147 


JOERP 


! Reply input area 


F 


-+- — 


-+ 


1 


'"~ ^ "••-"• ' "■■ ' '< ••' -rrr L J 1 .IJ 1 . jui »-«•«>.».... mm. -... . ji i. mi ■■ .. ui i. > ■. ■«» 


j 328-329 


1148 


JOECC 


1 Cylinder number save area 


L 


^L 


— . JL—— . — 


x«. «. - - ^ . 



-i 



Figure 5.45. 3540 Diskette Work Space (Part 1 of 2) 
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Bytes 



Dec 



Hex 



H 



^^ . 

I 

Label j Description/function of field 
of field] 



330-331 

332 
333 
33a 
335 



14A--14B 

14C 

14D 
14E 
14F 



1336-343 

L-* 



-^«+« 



j Physical reader information indicators. 

i 

! 

I The following indicators are copied from the physical work 

j space to prevent them from being (destroyed should the open 

j be unsuccessful. On a successful open,, the indicators in 

I the physical work space are overwritten by these updated 

I indicators. On an unsuccessful open,, only the open 

I indicator 'PEOC" will be updated with the stop code 'S*. 

j (See Figure 5-.15,.) 

I 

WERL i Record length (copy of PERL) 

WESI ! Sequence ID (copy of PESI) 

WEMI jMultivolume identification (copy of PEMI) 

WESN [Volume sequence number (copy of PESN) 

WEOD I Number of opened diskettes (copy of PEOD) 

WEND [Number of. diskettes to be read (copy of PEND) 



1150-157 

«JL 



[Not used 
^j. 



Figure 5.a5. 3540 Diskette Work Space (Part 2 of 2) 



Byted 
r* 



Dec 



Hex 



h 



1128-131 

1132-137 

1138 

1139-164 

1165-178 

1179-202 

1203 

1204-205 

1206 

I 207 

i 



180-83 
I 84-89 
|8A 

I 8B-A4 
IA5-B2 
1B3-CA 
|CB 

1 CC-CD 
|CE 
JCF 
-i 



-fLabel 
lof fie 



|VOLL 
IVLID 
IVLSN 
|VLAI 

I 

JVLDI 

I 

I VLPL 
JVLRS 

I 

1 VLST 



j Description/function of field 
Id! 
^ 

I Diskette volume 1 label 

I Volume label ID and number 

I Volume serial number 

I Volume access indicator 

j Reserved 

[Volume owner identity 

[Reserved 

1 Physical record length 

[Physical record sequence code 

[Reserved 

[Label standard version (W) 



-H 



_/ 



Figure 5.46. 3540 Volume 1 Label Layout in Label Test Area (OELB) 
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Bytes 



v.^u^.*m.mm.^mjm..mm.jm.-mj^ 


«i. ^..» •.«•«»«»«.«» .ii... 


jucijjc;x 


Dec 


1 Hex 


Of field 




1 


HDRL 


128-131 


180-83 


HDID 


132 


1 84 




133-140 


I85-8C 


IHDFI 


141-149 


1 8D-95 




150-154 


!96-9A 


HDBL 


155 


1 9B 




156-160 


|9C-A0 


HDLO 


161 


|A1 




162-166 


1A2-A6 


HDHI 


167 


|A7 




168 


|A8 


HDBI 


169 


|A9 


HDFS 


170 


|AA 


HDWP 


171 


|AB 


HDEI 


172 


|AC 


HDMV 


173-174 


1 AD-AE 


HDSN 


175-180 


! AF-B4 


1 HDCR 


181-193 


IB5-C1 




194-199 


1C2-C7 


HDEX 


200 


iC8 


HDVI 


201 


1C9 




202-206 


1 CA-CE 


HDED 


207 


|CF 






•.X — . 






Diskette header 1 label 

Header label ID and number 

Reserved 

File identifier 

Reserved 

Block length of data record 

Reserved 

Begin of extent (CCHRR) 

Reserved 

End of extent (CCHRR) 

Reserved 

Bypass indicator (B) 

File security indicator (S) 

File write protection indicator (P) 

Basic exchange indicator ( ., E) 

Multivolume indicator ( „C,/L) 

Volume sequence number 

Creation date 

Reserved 

Expiration date 

Verify indicator ( ,V) 

Reserved 

End of data address (CCHRR) 

Reserved 



— J 



Figure 5.47. 3540 Header 1 Label Layout in Label Test Area (OELB) 
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ASYNCHRONOUS SERVICE ANCHOR BLOCK 



Definition Macro: IPW$DAB 



V ^y 



The asynchronous service anchor block contains the queue pointers for all service 
requests to be performed by the service subtask. 

Storage for the anchor block is acquired the first time a POWER/VS task issues an 
attach request. The anchor block exists as long as POWER/VS is active. 

When a POWER/VS task uses asynchronous service, an IPW$IAS TYPE=ATTACH request must 
be issued first, before any other IPW$IAS TYPE=SERVICE request can be made. 



1 Byte 


s 


— 1 

1 




: , 


1 — 


"T" 




-J 


Label of 


Description/function of field 


1 Dec 


1 


Hex 




field 




L _________ . 






1 




, .. 




-f- 




— 1 




- — ---—----—---—---—---- — ----—----——--—--"'—--———-———■"————— 


] 00-15 




00-OF 






Storage descriptor (ASWS) 


1 16-19 




10-13 




ABNEXT 


Address of first service request in queue (zero if no 
entry) 


1 20-23 




14-17 




ABLAST 


Address of last request in queue 


] 24-27 




18-1B 




ABECB 


Subtask event control block 


1 28-31 




1C-1F 




ABLCK 


Lock word 


1 32-33 




20-21 




ABTIK 


Task identification key (TIK) of asynchronous service 
subtask. 


[ 34-35 




22-23 




ABUSCT 


Use count 


1 36-39 




24-27 




ABADR1 


Address of SETPRT routine (IJVSRPDV) in SVA 


1 40-43 




28-2B 




ABECB 2 


Event control block 


1 44-51 




2C-33 




ABWFLD 


General purpose work field 


] 52-55 




34-37 






Unused 


1 


-i_ 




-J 


ABLN 


Length of anchor block 



Figure 5.47.1. Asynchronous Service Anchor Block 

SERVICE REQUEST BLOCK (SRB ) 

Definition Macro: IPW$DSR 

A service request block is created whenever a service request is passed to 
asynchronous service for processing. 

During the time asynchronous service is performing the service request, the SRBs are 
chained together. 

Asynchronous service handles the request on a 'first-in first-out' basis. 



'^y 
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1 




■ 


~ 


.— _ 


— T 










Bytes 






Label of 


Description/function of field 


1 




I 






1 




Dec 


1 




Hex 




field 




1 




1 






J. 


— , 


L _ _ _ _ — _— _ _ __ — _i_— __ — .i- _ _ _ — _ _ _ 


j 00- 


■03 




00- 


-03 




SRBNEXT 


r ---- 

Address of next SRB in chain 


1 04 






04 






SRBREQ 


Request type 

C'S' - SETPRT request (SRBSPR) 


1 05 






05 






SRBTRC 


Return code (low-order byte of register 15) 


] 06- 


-07 




06- 


-07 






Reserved 


1 08- 


-11 




08- 


-OB 




SRBECB 


Event control block (POWER/VS task, issuing service 
request, waits on this ECB, which is posted by the 
service subtask) . 


1 ^'^- 


-23 




OC- 


-17 




SRBPARM 


Request parameter list: 

This field is broken down differently for each service 
request type: 
[SETPRT request 




Byte 00-03 Address of SETPRT parameter list 
















04-11 unused 


I 






- 






SRBLN 


Length of service request block 



I — 1 I 1 



J 



Figure 5.47.2. Service Request Block 
AS SIGN/UNAS SIGN WORK SPACE 

The work space is primarily used as a register save area and to contain printer setup 
information when a 3800 printer is being unassigned and asynchronous service is 
invoked to set up the printer with the system/hardware defaults. 

DSECT Name: LUWS 



r 




1 




._-.j. 




1 Bytes 


1 




1 




1 


'T 


-H 


Label 


of| Description/function of field 




1 Dec 


1 Hex 




field 


1 




L. . 


.X 






L «. _ _ _ 




] 00-15 


1 00-OF 






1 Storage descriptor ('LUWS') 




I 16-71 


I 10-47 




LUSV 


1 Temporary register save area for the 
] functions. 


interface between 


] 72-79 

1 


1 48-4F 




LUGR 


1 Save area for registers 14-15. Used 
1 is invoked. 


when another function 


I 80-147 


1 50-93 




LUSP 


] SETPRT parameter list 




] 148-151 

1 


] 94-97 




LULN 


1 Not used 

1 Length of assign/unassign work space 





Figure 5.47.3. Assign/Unassign Work Space 

380 TCB EXTENSION AREA 

This control block is constructed: 

1 . At job execution time whenever a 3800 printer is being spooled. 

2. At print time when the printer is a 3800. Like the TCB, the 3800 TCB extension 
area is built in real storage and exists as long as the task exists. 

The control block contains device status information of the current or new printer 
setup. The TCB extension is pointed to by the TC3E field in the TCB. DSECT name is 
IPW$DTE. 
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J. , ^ -„ J 

1 Bytes 1 1 

1 Lable of iDescription/function of field 

' Dec ' Hex i field i 1 
L J J - « I - __ „ - . 1 


r j il _--_ - «_-. j 

1 00-01 00-01 TE38LU |Logical unit number or physical device address | 
1 02 ' 02 1 TE38RQB jRequest byte I 
j 1 TE38SRI 1 x'80' SETPRT required 1 
1 1 TE38DFLTI x*40' default setup required I 
1 1 TE'38DGMT} x'20' segmentation required | 
,03 03 1 TE38FLG Unused j 
04 04 1 TE38CGI |Current copy group index 1 
' 05-07 05-07 ' IReserved for future use i 

L J J ; _ >___„„ 1 

1 [General work area 1 
L L * _T _ _ « > « - - - J 


08-27 08-1B j TE38GW |This area may be broken down into fields in whatever way j 
1 , 1 lis required by the task. 1 
L -. _ '_ _ „j _j. __ ». ____- _ _ « _ 


, 1 ^, 7 -~ "- — - 1 

' 1 Overlay area for EXTRACT/MODCTB parameter list 1 


08-27 1 08-1B 1 SVC98PL |Parameter list for EXTRACT/MODCTB 

08 ' 08 I SVC98ID ^Indicator for SVC 98 routine , 

[ 1 PUB2EXID] x'01' *ID for extract PUB2 table 1 

1 PUB2M0ID x'FO' ID for modify PUB2 table I 

1 09 j 09 1 SVC98FL |Flag field 1 

j 1 1 PHYSUNITi x'01' physical unit ID flag j 

110-11 1 OA-OB 1 SVC98RS IReserved 

1 12-13 1 OC-OD 1 SVC98LN ILength of user area 1 
I 14-15 ] OE-OF [ SVC98DI [Displacement in PUB2 table 1 
1 16-19 10-13 SVC98AR [Address of user area ' 
1 20-23 1 14-17 , SVC98SE |Address of logical or physical unit j 
124-27 1 18-1B 1 SVC98PI lAddress of user-specified PIK j 
1 2 8-31 1 1C-1F 1 IReserved for future use 1 



^...■^■^ 



Figure 5.47.4. 3300 TCB Extension Area 





Bytes 
























"--I 


Lable of 


Description/function of field 








r 








Dec 1 


Hex 


1 


field 










— -4 


""""" 


f - 


._— — - 


"1 




r " 








1 












SETPRT 


parameter list 




-J 


32 


" T" 


20 


1 


SPLLNGTH 


Length 


of SETPRT parameter list 






33 




21 




SPLFLAG1 


Flag byte 1 














SPLLUADR 


X 


80' 


Field SPLLUNIT contains the 


address of the LUB 












SPLINIT 


X 


40' 


INIT=Y was specified 














SPLBURY 


X 


30' 


BURST=Y was specified 














SPLBURD 


X 


20' 


BURST=* was specified 














SPLBURN 


X 


10' 


BURST=N was specified 














SPLUDCHK 


X 


08' 


DCHK=U was specified 














SPLNOMSG 


X 


04' 


suppress setup message to operator 












SPLMARK 


X 


02' 


SEP=M was specified 














SPLOFFST 


X 


01 ' 


SEP=0 was specified 






34 




22 




SPLFLAG2 


.Flag byte 2 














SPLFCBV 


X 


80' 


FCB verification was reques 


ted 












SPLQSPRT 


X 


40' 


Query SETPRT was requested 














SPLTRCY 


X 


30' 


TRC=Y was specified 














SPLTRCN 


1 X 


10' 


TRC=N was specified 














SPLDEBTR 


1 X 


•OE' 


DEBUG=TRAC was requested 














SPLDEBDU 


X 


•OA' 


DEBUG=DUMP was requested 














SPLDEBTE 


1 X 


'06' 


DEBUG=TERM was requested 














SPLDEBNO 


1 X 


•02' 


DEBUG=N0Rr4 was requested 








L_ 




_J 


SPLRSVD3 


1 X 


'01 ' 


Reserved 




— -J 



Figure 5.47.5. SETPRT Parameter List (Part 1 of 2) 
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'-]' 



Bytes 


Lable of 


Description/function of field 




,^-^Jl^. 


Dec 


field 




35 


^3 


SPLRSVD1 


__ ___ ___ ___ ___ __ ___ ___ __ __ __ __ ___ ___ __ __ __ __ ____ ____ ___ ___ ___ _ 

Reserved 


36-39 


24-27 


SPLFCB 


Last 4 characters of the FCB phase name 


40-55 


28-37 


SPLCHAR 


Character arrangement tables 


40-43 


28-2B 


SPLCHAR1 


Last 4 characters of first translate table 


44-47 


2C-2F 


SPLCHAR2 


Last 4 characters of second translate table 


48-51 


30-33 


SPLCHAR3 


Last 4 characters of third translate table 


52-55 


34-37 


SPLCHAR4 


Last 4 characters of fourth translate table 


56-59 


38-3B 


SPLCMCHR 


Last 4 characters of the translate table phase name 
specified in the MODIFY keyword. 


60-63 


3C-3F 


SPLCPMOD 


Last 4 characters of the copy modification phase name 


64-67 


40-43 


SPLFORMS 


Paper forms ID 


68-71 


44-47 


SPLFLASH 


Forms overlay ID (Flash ID) 


72-79 


48-4F 


SPLCOPYG 


Copy groups 


80 


50 


SPLCINDX 


Copy group index 


81 


51 


SPLFLSHC 


Flash count 


82-83 


52-53 




Reserved 


84-87 


54 


SPLLUNIT 


Address of LUB 


84-85 


54-55 




Reserved 


86-87 


56-57 


SPLLUSYS 


Logical unit number 


88-91 


58-5B 


SPLREG1 


Register save area 


92-95 


5C-5F 


SPLREG2 


Register save area 


96-99 


60-63 


SPLREG3 


Register save area 



1 



I 100-1 19 I 64- 
I 1 



77 



I Reserved for SETPRT parameter list extension 
-L 



Figure 5.47.5. SETPRT Parameter List (Part 2 of 2) 
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SPOOL PARAMETER LIST (SPL) 

The SPL is the means of cross-partition communication between POWER/VS and another 
program using the PUTSPOOL,^ GETSPOOL or CTLSPOOL interface,. When POWER/VS receives 
control, the SPL address is located at the user's XECB+Si, and spool management 
initializes the address in the TCB (TCPL) for use by POWER/VS. The external interface is 
described in the DOS/VS Supervisor and I/Q Macros manuals 



Dec 



Bytes 
I Hex 



"T 






00-02 
03-10 
11 

12 



13 



14 



15 



16-23 
24-31 



00-02 
03-OA 
OB 

OC 



OD 



OE 



OF 



110-17 
I 18 -IF 



Label 
of field 



SPHD 
SPJB 



SPER 
SPIA 
SPLA 
SPPA 
SPBA 
SPPP 
SPSP 
SPLP 
SPCP 
SPAP 
SPUE 
SPLE 
SPBE 

SPPE 



SPSE 
SPPI 
SPJI 
SPCI 
SPDI 
SPNR 
SPLR 

SPRl 
SPEJ 

SPR2 
SPRP 
SPRD 
SPRC 
SPRJ 
SPCX 
SPSC 
SPST 
SPPC 

SPR3 
SPLD 
SPPO 
SPBR 
SPCO 

SPXR 
SPXL 



Description/function of field 



SPL header {'SPL') 

Job name 

Blank delimiter 

Error feedback 

X* 80* - Invalid address 



-i 



X'SS" - Invalid SPL address 

X^8a' - Invalid POWER buffer address 

X'82' - Invalid data buffer chain 

X''4 0* - Diagnostic logged by POWER/VS 
X'48' - During PUTSPOOL processing 
X'^U" - During GETSPOOL processing 
X'42* - During CTLSPOOL processing 
X'41' - POWER/VS terminated 

X'20' - Processing error 



X* 
X" 

X* 



X' 

xno' 



28" - Invalid CTLSPOOL request 

24* - Loop in PUTSPOOL buffer chain; or,, more than 

4096 buffers used per request 
22' - GETSPOOL was unable to locate output file by 

specified job name,, job class,, and dispatchable 

POWER/VS disposition; or,^ requested output file is 

in use 
21' - Buffer area too small (8 8-byte minimum) 
Invalid parameter 



X'18' - Invalid job name 
X'la' - Invalid class 
X'12' - Invalid disposition 
X'OO' - Normal return 



X'08' 



End-of-data on GETSPOOL 



PUTSPOOL request type 

X'4 0' - The last data record for informal reader job is 

contained in this PUTSPOOL request 
CTLSPOOL request type 
X*01" - Route to new priority 
X'02' - Route to new disposition 
X«04' -- Route to new class 
X'08' - Route to new remote ID 
X'lO' - Cancel from RDR queue 
X'20' - Scratch from LST queue 
X*40V - Display job status 
X'80" - User-supplied POWER command 

GETSPOOL request type 
X'Ol* - GETSPOOL request 
X"0 2' - Position on Q-record 
X'04' - Position on line number 
X-08' - Return control characters 

PUTSPOOL user's'XECB name 
GETSPOOL/CTLSPOOL user * s XECB name 



—J 
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i. ^ + + 



Bytes 
r 



Dec 



Hex 



^ Label 
of field 



32-35 
36-39 
aO-43 

U8 

49-51 

52 

53 

54 

55 



56 
57 

58 



59 



20-23 
24-27 
2 8-2B 
2C-2F 

30 

31-33 

34 

35 

36 

37 



38 
39 

3A 



3B 



SPCB 
SPPB 
SPBL 
SPRL 
SPRS 
SPSN 
SPCT 
SPCL 
SPDP 

spec 

SPSQ 



SPQD 



BPNV 



SPLN 



Description/function of field 



Address current PUTSPOOL buffer area 

Address user- supplied buffer area for POWER 

Data buffer area length 

Data record length 

Browse control 

Signed browse start control 

Browse start line number 

LST output class 

LST output disposition 

Print/POWER control character 

Display job status return 

C'N' - Not on POWEIWS queues 

C'R* - On RDR queue 

C'L' - On LST queue 

Job disposition on RDR/ LST queue 
Unused 

CTLSPOOL new value 
PRI= 
DISP = 
FLASS= 
REMOTE= 

Spool parameter list length 



— J 
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RELATIONSHIPS BETWEEN POWER/VS CONTROL BLOCKS AND DATA AREAS 



This figure contains a set of examples which illustrate the interrelationships between 
the POWER/VS control blocks and tables. The examples are based on the assumed position 
of six separate jobs at an assumed point in time (time "t")- Note that the illustrations 
do not represent true situations. 



Time "t" 



PSTART F4 



Task 1 



. Time 



TCB for an execution 
task for jobs in F4 



PSTART RDR.OOC 



Task 2 



TCB for a RDR task 
input class A 



i i Central Operator PSTART RJE, 030, KENTOMS 
Remote operator *"5 . .t SIGNONt 1, KENTOMS 



Tasks 



TCB for a RDR RJE task 
invoketj on line 030 input 
class A by default 



PSTART LST, OOE.F 



Task 4 



TCB for a 
LST task 



PSTART PUN.OOD 



Tasks 



TCB for a 
PUN task 



PSTART F2 



Task 6 



TCB for an execution 
task for jobs in F2 



Time "t" 



-Time - 



Figure 5.48. Part 1: Assumed position of six tasks at time "t" 
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( 



( 




v^ Control Address Table (CAT) 
(See Figure 5.4) 

Field TMTN in WCB points to first 
TCB in TSL 

Wait Control Block (WCB) 
(See Figure 5.5) 

Field TCNT in the TCB points to 
the next TCB in the TSL. 



Command Processor Control Block (CPB) 
(See Figure 5.13) 



The TSL. Note that the order of TCBs in this 
illustration does not represent the order in which 
they would be printed in a dump output but in 
their priority within the TSL. 



J 



Figure 5.48. Part 2: 



The Task Control Blocks (TCB) 
(TSL) 



linked into the Task Selection List 



C 
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Before proceeding it is necessary to understand the method of presentation used in the 
other parts of the figure. 

Each table or block in the following diagrams is represented by a block divided 
horizontally into eight boxes* Each box represents a 4-byte field within a table which 
is 32 bytes across, thus matching the number of bytes printed in each line of a standard 
dump as shown below. 



Standard Dump Output 



Hex Code 



Alpha Code (translated output) 



X 

X'140' 

J. 




Partition Save Area 



WCB 



ATCB 



A LRSA 



■ Partition ID 



-32 bytes - 



1^ 

4 Bytes 

















^— — 


_-. 




- - 






- 




.I—. 


— 




^^^ 













F 


^^ 


i L_ 






n 



c 



R5 points toa CB 



Figure 5.U8. Part 3: Method of presentation and task conditions 

These tables in the permanent area are illustrated in the order in which they are printed 
in the dump. The symbol t indicates a pointer. For example,, R5t queue record indicates 
that register 5 contains the address of a queue record. 

Furthermore, the assumed status of each task at time "t" is described in the figure 
captions for each task represented in the following parts of this figure. 
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c 



( 



Pointer from previous TCB in TSL, in this example it is 
' the TCB for the line manager (Task 3) 

• To previous TCB 




. Pointer to next TCB in TSL, in this 
example it is the TCB for Task 3. 



X'OO' = I state 



) ... 



ar Save area for IPW$$CP 



X'FF' = locked resource 

Pointer to TCB of task using the resource 

> Module Control Block 



Link to TSL 

X'D3' = L state 

points to L state processing in nucleus 



TCB for execution reader task in F4 



I LRSA for registers used by IPW$$XW 



points from the 
partition control 
block F4. 
(see part 1 of 
this Figure) 



R6 points to partition control block (PDB) 

X 'D7' = P, identifies this queue record as being In punch queue 

\ Queue record 



Data area 



Figure 5.48. Part 4: Relations between data areas in use by task 1 



Task 1 ; 

<> The permanent operator command processor TCB in the permanent area is in I state 
waiting for the operator to enter a command. 

e Execution reader processor TCB in L state - task waiting for a locked resource. (The 
Module Control Block of Data File 2 is being used by another task.) 
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R3 points to MCB 



R1 points to CCB waiting' 
to be posted 




Link to TSL 

X'C3' = C state 

points to C state processing routine 

in nucleus 



TCB RDR in C state 
(See Figure 5.9) 



Task Register save area 
(See Figure 5.11) 



Queue record (See Figure 5.22) 



to CCB and 
channel programs 



Physical data area (PDA) 



Physical Work Space (PWS) 
(See Figure 5.15) 



Figure 5.48, Part 5: Relations between data areas in use by task 2, showing the PWS and 

PDA 



Task 2: 



« TCB for Reader task, class A,, in C state waiting for disk output (CCB posting) 



9 Task was executing code in a logical routine. 



j9 CCW chain for input consists of six CCWs. 






2m DOS/VS POWER/VS LogiC: 



( 



points to BCA from LCB 



points to record in PDA 
being processed 



SKAD of data record in track group 



'v/ICB DFILE2 



CCW points to data record to be processed 



TCB for RJE RDR task 
on line 030, rennote ID 01 
in 'P' state 




Rennote ID, and 
line number 

LCB (See Figure 5.32) 

No more LCBs chained 
ndicates the point to entry in the 



Figure 5,U8. Part 6: Relations between data areas in use by task 3 



Task 3: 



• RDR task on RJE line 30 from remote terminal 01, 



• Task in function PD transferring a data record from the PDA to the LDA, 

• The function was called by the logical routine IPW$$LR.. 

• During execution of the code in PUTDA a page fault occurred. 



• No more LCBs are chained, 
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Record control fields 




X'OO' = This queue record is not the 
first of a queue set 



X'D3' = L, identifies this queue record as being for a LST task 
X'Cr = A, identifies this as class A 
X'F4' = 4, identifies priority value 



i 13 mi 



j I These labels refer to the next part of this figure 

Figure 5.48. Part 7: Relations between data areas in use by task 4 showing pointers to 

the Queue and Data files 



Task 4 J 



« LST task is in C state,, output class F,, that has read a queue record but not been 
dispatched. 

® The task is executing code in IPW$$NQ being called from the IPW$$LW routine. 

^ The queue record read is the second queue record of the second queue set in class 
chain F in the LST queue on the queue file. 



x_ 
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c 



rn These labels are references from the previous part of this figure. 



[a] SKAD of the MR (queue record on the queue file)- 

FbI SKAD of next queue record In same queue set -■ 
Label QRNS in part 9 of this figure 

fc] SKAD of this queue record ... 

3] Contents of first halfword in ECB in MCTA points 



M 



out relative number of first queue record of first 
queue set in a class chain. (Number is relative to 
queue record which is the MR. 
Contents of second halfword in ECB in MCTA 
points out relative number of first queue record 
of last queue set in same class chain. 

[e] SKAD of previous queue record in same queue set • 
Label QRPS in part 9 of this figure 

[F | SKAD of first queue record of next queue set in 
this class chain. Because this is not the first queue 
record in the queue set this will be 0. 
Label QRQN in part 9 of this figure 

[g] SKAD the first data block of the Track Group . 

[h] SKAD data record to be processed - 



Note: The order of queue records need 
not be continuous on the file as shown 
in this illustration. 




consisting of 3 queue sets 

(See part 9 of this figure for further details) 




Queue entries 
in the queue file 
(SYS001) 



Data file 
(SYS002 



Figure 5.48- Part 8: The queue and data file of task 4.. 



The queue record being processed (shaded) is the second queue record of the 
second queue set in a class chain (F). 
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Master Class 
table area (MCTA) 



Entry for LST class F 



QRQN 



QRDF 




y. 



QRNS 



AQRDA 
fiQRFS) - 


X'OO' 


QRNS 


> 


QRPS 


•-^ 


QRQN 





QRDF 



Note: All pointer addresses are seek addresses, 
except those in the MCTA entries, which point 
to queue records on the queue file relative to the 
MR which is record 1. (The shaded queue record 
corresponds to the queue record being processed 
as shown in part 7 of this figure). 



Figure 5,48. Part 9 : The Queue Set of task ^ 



vy 
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R13 



TCB for PUN 
in R state 



R13 




Figure 5,. 4 8- 



Q 



-^'R12 = address of the instruction at which processing most recently resunned 
i-^R14 = return after last function was handled 

» R15 = CSECT of last function 



I — ►R14 



BCW 



-► X'D9' = R state 

TRSA give state of registers before 
task was dispatched. 



fe 



LRSA for Physical routine IPW$$PP 

: return in CSECTIPP) 

LRSA for Logical routine IPW$$LW 



BCW I f 



► R 14 = return in CSECT I PW$$LW 

Part 10: Relations between data areas in use by task 5 



Task 5 ; 

• Punch task in R state executing code in PP routine after the IPW$OLI macro has been 
issued to open the interface with LW routine* 



C 



A PDB with three entries. 
(1 for RDR device entry, 
1 for LSTand 1 for PUN) 
(See Figure 5.21) 



Ell- 



Figure 5.4 8^ 




■^^X'C6F2' = Partition ID = F2 for this PDB 
entry in DOS/VS PIB for F2 



LST Device Entry 



L^- points to entry in DOS/VS PUB for LST spool device 



R3 points to locked resource 



TCB for execution list task 
in L state 



Partition CB R6 



Part 11: Relations between data areas in use by task 6, showing the PDB 
for this execution list task 



Task 6 : 

• Execution List processor task for F2. Task is in L state waiting for a locked 
resource. 
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Section 6: Diagnostic Aids 



v.„,> 



This section consists of error diagnostic flowcharts that indicate a method of dump 
analysis to isolate the cause of a software error (a bug) in the POWER/VS SCB, 

The flowcharts do not represent the only method of analysis but are hints and suggestions 
about "where and what" to look for in a dump containing the POWER/VS partition. 

The level of analysis becomes more detailed if the analysis progresses to a lower level. 

Recommendations on the use of debugging aids as described in DOS/VS Serviceability Aids 
and Debugging Procedures /^ GC33--5380/, are given., together with suggestions regarding 
program reruns in order to eliminate componentSr. 

The section begins with a list of general debugging hints. 

REFERENCE LIST OF GENERAL DEBUGGING HINTS 

1. The Standalone dump and SYSVIS (PDS) dump 

2. Identifying the POWER/VS partition (the partition in which POWER/VS is initialized) 
3^. Identifying pages belonging to the fixable area 

U. Identifying the start of the pageable area 

5. Locating and identifying control blocks, tables and areas 

6. Identifying the start of a CSECT 

7. Establishing the "level" of a CSECT 

8,. Determining the active routine and analyzing the register save areas. 

9. Analyzing event control blocks 

10. Using the buffer control words 

11. Analyzing TCBs 

12. Establishing queue records in queue sets and class chains 

13. RJE,, ESC I/O track wraparound buffer 
lU,. POWER/VS file dump program 

15. Establishing the last command issued 
16,. An aid to eliminate components 
17. Problems related to VTAM. 
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General Debugging Hints 



1. STANDALONE DUMP 

It is recommended that the user generate a formatted standalone diamp with translation 
(DUMPGEN parameter,^ •FORiyiAT=YES. See DQS/VS Serviceability Aids and Debugging Procedure 
for detailed description-) 

This dump should always be used when a standalone dump is required. Formatted page 
tables will save time in converting virtual to real addresses. 

After executing a standalone dump,, it is advisable to use the SYSVIS dump, as recommended 
and described in Section 2 of DOS/VS Serviceability Aids and Debugging Procedures , to 
dump^ or copy, the POWER/VS virtual partition. This dump will be required to complete an 
offline analysis of the error. 

2. IDENTIFYING THE POWER/VS PARTITION 

The start of the POWER/VS partition can be easily identified in the translated portion of 
any dump by the name given to the POWER macro. The characters CAT,, ten lines under that 
name, identify the control address table- 

3- IDENTIFYING FIXED PAGES 

The address of the first page in the fixable area is contained in bytes 18-lB of the CAT. 
Since each page is 2K bytes,, the start of other pages in the fixable area can be 
calculated. Also, by examining the contents of the Page Control Table in the SCB the 
amount of pages and usage of each page can be established. 

4, IDENTIFYING THE START OF THE PAGEABLE AREA 

The address of the pageable area is contained in bytes IC-IF of the CAT. 
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5.. LOCATING AND IDENTIFYING CONTROL BLOCKS, TABLES,, AND AREAS 
In the Permanent Area 



I Abbreviated* 

[Mnemonic of Table or Area 

^ 

I AQRA 
ICAT 



— ^-^ . 

I 

I Pointer to or Address 
I of the Table/Area 
_^. ^ ^ 



I 



|MCTA starts at X'280' of .DMB| 



I Start of POWER/VS partition 
jsave area (PSA***) plus 
|X«140' 



jMLT 

|MMB 

IMRA 

IPOWER/VS PSA*** 

IDMB 

I SCB 

I SYSCOM 

[Start of POWER/VS part 

I 

1 WCB 



IX' 148' -X'157' of DMB 
]X'74' - X'77' of CAT 



|X'5C' 
|X'68« 
|X'70' 
1X'80' 
I X' 5C • 



X* 5F' of SYSCOM 

X'6B' of CAT 

X*73* of CAT 

Of LAS ** 



X'83' 

X' 5F' of SYSCOM 
lalso X'lU' - X"17' of CAT 
|X*D8' - X'DB' of CAT 



Identification in the 
translated dump output or 
remarks 



Execution date of POWER/VS 
CAT and version/modification 
level 

No special identity 

No special identity 

MMB 

Execution date of POWER/VS 

Name of POWER/VS generated 

DMB 

SCB 

Name of POWER/VS generated 

WCB 



"H 



* Refer to "Abbreviation List" in Appendix A. 

** LAS = Low address storage as described in DOS/VS Serviceability and Debugging Aids <. 

***PSA = Partition save area as described in DOS/VS Serviceability Aids , 



-H 






Figure 6.1. Part 1: 



Locating and Identifying Control Blocks, Tables and Areas in the 
Permanent Area 



In the Fixable Area (Actual tables present depend on task requirements) 



I Abbreviated * 

I Mnemonic of Table or Area 



.^_: . 

Pointer to or Address 
of the Table/Area 



I [Account file seek address 
I ACB 
I AQRA 



IBCA 
I [CPB 
jCP TCB 
JDLRSA (or second LRSA) 



I 
1 
I 
I 
I 
1 
I I 



I I 



End address ot POWER/VS 

partition 

Execution account record 

First fixed page 

IN IT/TERM TCB 

Last permanent page 

Line account record 

List account record 

LCB 

LDA 



X'180' 

X' 6C' 

X'F8« - X'FB 



X' 187' of DMB 
X'6F' of CAT 
of DMB 



X'40' - X«43' of the LCB 
X'EO' -X'E3' Of the CP TCB 
X'DC - X'DF' of CAT 
R13 in TRSA for task 
executing code in logical 
routines X'4' • X»7' in LRSA 
(in TCB) for task executing 
code in physical routines. 
Subtract 1 from contents of 
X'20* - Xr23« of CAT 



Figure 6.1. Part 2: 



See AARA 

X'la* - X'17' of SCB 

X'E4' - X'E7' of CAT 
X'18' - X'lB' of SCB 
First 56 bytes of LCB 
See AARA 

X'21C'- X'2lF'of CAT 
X*88* - X'8B' of a TCB (not 
a CP TCB or line manager 
jTCB) 
» X . . .^. 

Locating and Identifying Control Blocks,, Tables and Areas in the 
Fixable Area (Part 1 of 3) 



Identification in the 
translated dump output 



— ^ 



This is a real address 
(Virtual is in X'5C' - X'5F' 
of DMB) 



TCBbObCP 



TCBblbIT 



This is a real address 
I (virtual is in X'C • X'F' 
jof LWS) 
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Abbreviated * 
MNEMONIC OF Table or Area 
|. 

LMF (Line Manager Fields) 



LRSA 



MCB for Q file 

MCE data file 1 

MCB data file 2 

MCB data file 3 

MCB data file 4 

MCB data file 5 

MCB private SSL 

MCB system SSL 

MRA (starts at X'lOO' of DMB 



MSCB 

PDB (partition CB) 



PCB 
PDA 



PWS 



QRA (Queue Record Area) 



QR identity 

Size of data buffer 

Size of data block 

SKAD of account file 

SKAD of MR 

SKAD of next QR 



SKAD of previous QR 


|X'260' 


SKAD of current QR 


X'110' 




X'FO' 


SLI work space (SLW) 


|X'30' 


SNCB 


X'7C' 


Start of fixable area 


|X'18« 



Start of pageable area 
Start of TSL 

Tape control block (data) 
Tape control block (Q file) 



Pointer to or Address 
of the Table/ Area 



Identification in the 
translated dump output 



X' 80' - X'F7' of a 

TCB for an RJE Line 

Manager task. 

X'CO" - X'E7' of a TCB for 

an RDR, LST,, PUN, or XP task 



X' 8C' 


- X'8F' 


of 


CAT 


X'90' 


- X'93' 


of 


CAT 


X'94' 


- X'97' 


of 


CAT 


X'98' 


- X'9B' 


of 


CAT 


X'9C' 


" X'9F' 


of 


CAT 


X'AO' 


- X'A3' 


of 


CAT 


X'A4' 


- X'A7' 


of 


CAT 


X'A8' 


- X'AB' 


of 


CAT 


X'E8' 


- X'EB- 


of 


DMB 



X'5C - X'5F* of CAT 

X'AO* • X'A3' Of the 

partition COMREG and R6 in 

TRSA in a TCB. 

First 24 bytes of each page 

in fixable storage 

X' 04' - X^07' of a PWS 



R8 in a TCB for a task in a 

physical routine 

X'110' - X'113' of a TCB 

(Not a CP TCB or a Line or 

SNA Manager TCB) 

X'2A* of a queue record 

X'20C' - X'20F' of CAT 

X'210' - X'213' of CAT 

X' 180' - X' 187' of DMB 

X'EO' - X'E7' of DMB 

X'E8' - X'EF' of a DMB 

X'267' of a DMB 



- X' 113' of TCB and 
X'F7' of DMB 
X'33' Of PDB 
X'7F' of CAT 
X'lB' Of CAT 



X'lC - X'lF" Of CAT 
X' 14' - X'17' of WCB 
X'FO' - X'F3' of TCB * 
X'110' - X'113' of TCB * 
* Not CP TCB or Line or 
SNA Manager TCB 



1 



This LRSA is always the 

first,, and is used to save 

registers 14-9 used by the 

physical routines 

MCB QFILE 1 and physical 

address of device 

MCB DFILE 2 and physical 

address of device 

MCB DFILE 3 

MCB DFILE 4 

MCB DFILE 5 

MCB DFILE 6 



This is a real address.. 

(Virtual is in X'EC - X'EF* 

of DMB) 

MSCB 

PDB 



This is a real address- 
(Virtual is in X'08' - 
X'08' of a PWS.) 
Note: For an RJE task the 



address of the PDA is 
X'61' - X'63' of the BCA. 



This is a real address 
(Virtual is in X'AC - X'AF* 
of a TCB) 
R or L,, or P 



See Table 1 and 2 in 
Figure 5.12 
See Table 1 and 2 in 
Figure 5.12 



SNCB 

Each page in fixable area 

starts with a PDB.. 



TBB 



J 



Figure 6.1. Part 2: 



Locating and Identifying Control Blocks, Tables and Areas in the 
Fixable Area (Part 2 of 3) 
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Abbreviated * 

MNEMONIC OF Table or Area 



TCB of most recently 
attached auxiliary command 
processor 



Pointer to or Address 
of the Table/ Area 

X'F8' - X'FB' of CAT 



TCB for most recently 

attached execution 

processor task 

TCB of highest priority 

in TSL 

TCB for line or SNA manager 

(if present) 

TCB for most recently 
attached Writer task 
TCB for most recently 
attached RJE task 
TCB for most recently 
attached reader task 
TCB for line manager 
TRSA 
TSL 



X'104' 



XM07* of CAT 



X'lU* « X'17' of WCB 
X'FO* - X'F3' of CAT 

XMOO* - XM03' of CAT 

X'FC - X'FF' of CAT 

X' 108 - X' 10B of CAT 

X'E8' - X'EB' of CAT 
X'40' -- X'77' in any TCB 
X«ia« • X'17' of WCB; then 
X'14' - X'17' of each TCB 
until return to WCB 



Identification in the 
translated dump output 

If no auxiliary command 
processor exists^ this 
location contains address of 
TCB for the permanent 
command processor (CP TCB). 



If line manager not present,^ 
this location contains 
address of WCB. 



Recognize each TCB by its 
storage descriptor, (See 
debugging hint number 11^) 



\ y 



i* Refer to "List of Abbreviations" in Appendix A. 

L 



Figure 6,.l, Part 2: 



Locating and Identifying Control Blocks;, Tables and Areas in the 
Fixable Area (Part 3 of 3) 



'K..y 



In the DQS/VS GETVIS Area 



[Abbreviated * 

(MNEMONIC of Table or Area 

|. 

I COCB 
|LRCB 
ILUCB 



IRMCB 
I SUCB 

I 

IWACB 



j Pointer to or Address 
jof the Table/Area 
+ ^ 

IX' 8C' - X'8F" of SNCB 

iX'Sa* - X'87' of SNCB 

|X'29' - X'*2B' of SUCB 

IX'39' - X'3B' of SUCB 

IX' 49' • X' 4B' of SUCB 

IX'59' • X'5B' of SUCB 

|X'69' • X'6B' of SUCB 

|X'79' - X'7B' of SUCB 

!X'20' - X'23' of SNCB 

iX'ia' - X'17' of SNCB 

JX'IO' -- X'13' of TCB 

|X'14' * X'17" of TCB 



[Identification in the 
[Translated Dump Output 



I COCB 
|LRCB 
I LUCB 
I 



I RMCB 
I SUCB 

I 

IWACB 



-^ 



j* Refer to "List of Abbreviations" in Appendix A, 



Figure 6.1. Part 3: 



Locating and Identifying Control Blocks,, Tables and Areas in the 
DOS/VS GETVIS Area 
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6. IDENTIFYING THE START OF A CSECT 

Each control section within the POWER/VS code is identified by a 16--byte control section 
descriptor in the following format. 



P ^ ^ 

1 Bytes I Name ) Description 



"H 



00-07 



[Control section name 

[This 8-byte field contains the alphameric name assigned to the control 

i section,. Since control section names are of four characters only, bytes U-7 

J will contain character blanks. 

.„ ^ ^ ^ 



08- 



1 Supported changes 

jThis 6-byte field identifies SDD changes and will in general contain the 
I version number and modification level of the control section in the form 
! " vnMnbbV. The initial contents of the field will be 'VSMObbV. 



] Local changes ^ 

]This field will be used to reflect changes made by other than SDD personnel. 

jits initial contents will be character blanks. 



1^ Check this field for non-SDD changes. 



-^ 



J 



c 



7,. ESTABLISHING THE LEVEL OF A CSECT 

The level of a routine (Physical, Logical, Execution,, Function/, Service, see Figure 2.1 
in Section 2) can be established by the first two characters of its CSECT name identified 
in a dump. For example,, if the contents of register 12 in a TCB points to an address 
within CSECT name AQCS, the calling routine (AQCS) is at FUNCTION leveL. 

8. DETERMINING THE ACTIVE ROUTINE AND ANALYZING REGISTER SAVE AREAS ' 

It is important to know the routine in which a task is executing code in order to be able 
to analyze the meaning of the contents of the registers saved. 

The contents of R12 in the TRSA in a TCB belonging to a task that is not in R state will 
address the instruction that will be next executed when the task is given control. The 
routine or CSECT in which this instruction is located can be identified in a dump by 
means of the storage descriptor. 

Figure 5.14 shows the relationship between the LRSA in TCB and the DLRSA or second LRSA, 
which depends on the calling sequence of POWEPv/VS routines. (See Figure 2. 1 in Section 
2.) 

Note: Register conventions are described in Section 3. 

9. ANALYZING ECBS (EVENT CONTROL BLOCKS) 

Several control blocks are equipped with ECBs, the condition of which (posted [bit 16 on 
(1)] or unposted [bit 16 off (0)1) may be important to problem analysis. See Appendix D. 



10. 



USING BUFFER CONTROL WORDS 



The four bytes immediately in front of any area contain the address of the task control 
block of the task which reserved the area. (See also Figure 5.20.) 



O 
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11. ANALYZING TGBS (QUICK REFERENCE ONLY) 

General meaning of the task management fields (TMF) . (See Figure 5.10 for details.) 



\^.y 



TCB 



Block ID = (TCB) 



fni 






Task ID 
Byte 0: R 



= task belongs to reader task 
W = task belongs to writer task 
E = task belongs to execution processor task 
L = task belongs to line manager 

= task belongs to command processor 

1 = task belongs to initiator /terminator 
Any numeric character = RJE task 

Bytes 1,2, and 3: bCP = command processor 
bIT = initiator/terminator 
RLM = line manager 
ACT - saving or deleting an account file 
TAT = status report 



- Address of device CUU or RJE line number 

- Terminal ID (000 for central operator) 

• Address of previous TCB in TSL 

- Address of next TCB in TSL 

- Page request word (0 when no page fault 
request condition is present) 

- Task state (l,P,O.L,M,C,R,Q,D,f=,or S) 

• Address of routine IPVV$$NU that tests 
for condition indicated by task state 



V.„.^. 



Virtual address of the byte that precedes 
the input area for a message reply (0 if no 
reply required or expected) 

' Virtual address of the byte that precedes 
the text Of a message to be output. 

* Event control block 
•Job bou ndary s wi tches 

- Termination type (b. U, C, F, E, S. H) 

• Task class list 
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( 



General meaning of fields in the TRSA. (See Figure 5.11 for details.) 



points to first instruction to be executed 
when tasic is next dispatched 

- points to an LRSA 



TCB 



77 



M 



C 



13 



♦ 5 



f 9 



♦ 3 



TRSA 



Each "box" represents 4 bytes 
Each line represents 32 bytes -■ 



points to instruction to be executed next after 
completion of current or last function 



.points to CSECT of last or current function 
used by task. Shows the last or current funtion, 

. points to a CCB or ECB if TCB Is in C, or S state 
to an ECB address list if task is in M or Q state 



{that is 
line in 



' points to a locked resource if TCB is in L state 

-points to CSECT of base routine used by task 

points to physical work space if task is reader 
~or writer 

- points to partition CB for execution processor 
.tasks 
may point to queue record 
the number of bytes printed per 
a translated standard dump 
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12, ESTABLISHING QUEUE RECORDS IN QUEUE SETS IN CLASS CHAINS 

I The contents of X'89' in a queue record can be X'OO' or X'Ol'. X*01' indicates that the 
queue record is the first in* the queue set. X'OO* indicates that the queue record is not 
the first in the queue set. 



\ ,,/ 



This determines the meaning of the fields QRNS, QRQP^ and QRQN as follows: 
QRFS = X'OO' (This queue record is not first in queue set) 



I Contents not Zero 



P — ^ . 

j Displacement I 

I in Queue [Contents is Zero 

I Record | 

|..^ + «. , •„-+ ^ 1 

I |X'90'-X'97* jThis queue record is the last|It is seek address of next queue 
j )in this queue set. | record in this queue set. 
|. 1„ ^^ . -.-. 

I JX' 98 '-X' 9F' j Cannot be zero. | It is seek address of the first 
I I j queue record in this queue set. 
i. 4 . ^ + ^ . ^. 1 

I |X'A0'-X*A7' [Must be zero. |Must be zero. | 

I J. . --^ — X . ^ — . J 



QRFS = X*01' (This queue record is first in queue set) 



^ , ^. 

I Displacement] 

jin Queue j Contents is Zero 

[Record | 

|. ^^ „ 

I jX'90'--X'97' jThis queue record is last in 



Contents not Zero 



1 same queue set. 

! 



I i X'98 '-X' 9F' jThis queue record is the 

I j first in the first queue set 

j I in class chain. 

I 1X'A0'-X'A7' I This queue record is the 

I 1 first queue record of the 

1 1 last queue set in this class 

I I chain. 

L, X 



It is the seek address of the 
next queue record in this 
queue set. 

^ .- « ^ 

I It is the seek address of the 
first queue record of the previous] 
I queue set.. 

It is the seek address of the 
I next queue set in this class 
I chains 



See also Figure 5.48, Part 9. 



^ 
\.^. 
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13- RJE,BSC I/O TRACE 

An I/O trace for an RJE, BSC line after SIGNON can be initiated by specifying YES to 
TRACE= in the PRMT macro- 
Entries are made in a wraparound buffer in the phase IPW$$TM.. The following information 
is recorded at every I/O interrupt from this terminal. 



X'OO 



, UP to 1 5 entries of 256 bytes 
each. The last entry is followed 
by a zero entry. 
Thus the last 
event may be 
easily identified. 



X'80' 



X'CO' 



X'EO' 



- 32 bytes - 



Buffer Control Area (BCA) 

151 Bytes 

(see Figure 5.33) 



Line control block (LCB) 
beginning with 'LCBBUFAD' 
72 Bytes 
(see Figure 5.32) 



X'98' 



First 16 bytes sent/received 



Last 1 6 bytes sent/received 



> Trace Entry 






The trace is to be used when RJE^BSC line errors occur or incorrect output is encountered 
which can be caused by the I/O operation. 

A dynamic^ continuous trace of BSC RJE activity may be taken using the following steps. 
The user should acquaint himself with SDAIDS before referring to these steps. 

• Obtain a dump of the POWER/VS partition. 

• Locate the POWER/VS line manager in the dump ("LMCS VxMy"),. 

• Within the line manager locate the constant "SDAID 'IF' >'V. 

• The instruction immediately following this constant is fetched when the trace area is 
full and wrap-around will occur. 

• Use SDAIDS instruction fetch at this location with OUTCLASS=PDUiyiP„X' AAAAAA',,X' BBBBBB' -, 
where "AAAAAA" is the virtual address of the start of trace area (beginning on the 
second DOS/VS page from the above instruction) , and "BBBBBB" equals "AAAAAA" + 
X'lOOOl. 

This will provide a continuous trace of activity on any or all lines generated with 
TRACE=YES in the PRMT macro. 

Note: Trace activity begins with SIGNON. 
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14. POWER/VS FILE DUMP PROGRAM / x 

This program enables any of the POWER/VS files (account,, queue, data) to be dumped on a "^^ -*' 
line printer assigned to SYSLST. An option is also provided to enable queue records and 
their associated track groups belonging to specific jobs to be dumped. 

How to Execute 

i 
The program is requested by JCL commands entered either via SYSLOG or SYSIN^ where SYSIN 
is assigned to a card reader. Before requesting ensure relevant assignments are made for 
the file to be dumped- 

Example Job Stream 

// JOB name 

// ASSGN (SYS0OO for Account file) 

(SYSOOl for Queue file) 

(SYS002-6 for Data files) 
// EXEC IPW$$DD 

When the program is loaded successfully,, the following message will be issued to SYSLOG: 

DUMP FUNCTION= 

At this point one of the following options can be entered via SYSLOG: 

• A (to specify the Account file) 

• Q (to specify the Queue file) 

• D (to specify the Data file) ^, 

• jobname[, jobnumber] enqueue] ^ 

• EOJ (to enable cancelation of the program or selection of a new option) 

^ The complete data file will be dumped. 

2 This enables (a) queue record(s) belonging to a specific job in the RDR„ LST, or PUN 
queue plus its associated track group(s) to be dumped. Job name may be 8 characters,, 
job number may be 6 characters. For the 'queue' option one of the following three 
entries can be specified: 

L, for LST queue (default) 
P,, for PUN queue 
R„ for RDR queue. 

After the dump is completed,, the message 

DUMP FUNCTrON= 

is issued to SYSLOG again to enable either a new option to be specified or the program to 
be terminated by the option EOJ. 

Format of Output 

For every 100 bytes, a block of four lines is printed. Line 1 contains the printable 
cha^racters in those bytes; line 2 contains the zone-part of each byte; line 3 contains 
the numeric part of each byte; line t* contains a scale indicating the position of the 
bytes in the string. 

line 1: CHAR // JOB POWJOBOl DATE 08/19/7U., 

line 2: ZONE 66t^DDC4DDEDDCFF4U444Ut^4a4U 4444CCEC4FF6FF6FF6 

line 3: NUMR 11016207661620100000000000 00004135008119174B 

line 4: 01-.. .5.. .10 15. . .20. •-. 25. .85 90...95.< 

A. Analyzing Information in a Dump of the Data File 

^1 y 

Establish correct contents according to data record layout (see Figure 5.16),. 
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B. Analyzing Information in a Dump of the Q File 

I Establish correct contents and chaining of the 184-byte Q records according to Q record 
layout (see Figure 5, 22). 

C> Analyzing Information in a Dump of the Account File 

Establish correct contents of the variable length records according to Account record 
layouts (five types, see Figures 5,26--5.30)* 

15- ESTABLISHING THE LAST COMMAND ISSUED 

The last command issued by the central operator can be seen printed in the translated 
part of a dump within the permanent command processor control block,, recognized by the 
storage descriptor CPB. 
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16,. AN AID TO ELIMINATE COMPONENTS 

It may be useful to have several different generation tables cataloged to CIL with at 
least a default version as originally supplied to the user. The various versions act as 
a debugging aid to eliminate components.. 

17. PROBLEMS RELATED TO VTAM 

If a problem occurs where VTAM is involved,, it is recommended to consult section "VTAM 
Serviceability Aids" (VTAM traces) in the DOS/ VS VTAM Debugging Guide ,, GC27-0021. 



4 ~ 

I 
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A System Dump Containing the POWER/VS Partition 



( 



POWER/VS 
permanent 
I area 8K 



GETVIS 



[ 


JOB NAME 1 


GPRs 


FPRs 


CRs 



Translated 

dump 

output 




■< r// v/ Partition ID 



0f Name given to the POWER/VS 
"l' macro at generation 



Storage descriptors 



Identifies pages belonging 
to the fixable area 



POWER/VS CSECT 
names 



^^ 



Figure 6.2. Pictorial representation of a systetr dump containing the POWER/VS partition 

For a full description of a system dump refer to DOS/VS Serviceability Aids and Debugging 
Procedures. 
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Diagnostic Charts 



The following charts are designed to guide IBM service personnel- 

They describe a method of software error analysis but are not intended to be foolproof • 

However, these charts indicate simple checks on system environment and enable information 
to be. gathered from a dump of the POWER/VS partition for given malfunctions. 

Contents 

Chart 01.. initial Environmental Checks 

Chart 02. Wait State 

Chart 03.. LOOP 

Chart 04. Incorrect Output 

Chart 05. Program Check (ABEND) 

Chart 06. POWER/VS not Initialized 
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c 



Chart 01. Initial Environmental Checks (Part 1 of 3) 



Check 



Method of Analytli 



Recommendatfom for 
Further Problem Anelytit 



CiMck 1 

System information 
available? 




Has the user completed problem 
determination as recommended in 
DOS/VS Serviceability Aids and 
Debugging Procedures (Section 3 
and Section 4, Part 1 )7 



No 



Yes 



Establish what the user has done to 
isolate the cause of the malfunction 



If you think the information he has 
gathered about the malfunction is 
not sufficient, go to check 2. 

If you have enough information to 
begin debugging, go to check 7. 



C 



Check 2 

Eliminate 
components (Level 1) 




Rerun the job under DOS/VS, that 
is.do not run as a POWER /VS job 




If the malfunction recurs, analyze 
it using the dumps obtained as 










and do not initiate a POWER /VS 




recommended in DOS/VS Serviceability 








partition. Ensure to include the 




Aids and Debugging Procedures. 




// OPTION DUMP statement In the 




If the malfunction does not recur. 




job stream and as an option initiate 




proceed to check 3. 




the SDA ID dump on program check. 
(For jobs entered under RJE you 












must submit the job stream and 






input data files to the central station. 






request output to be directed to a 








local LST and/or PUN. 







1 Check 3 1 

Progran-i fails when run 




Has the program ever run correctly 


Yes 


Check the following: 


under POWER/VS only 




under POWER/VS. 




• Changes in job stream JECL 

• Changes in the DOS/VS supervisor 

• Changes to data files/volumes 

• Changes to POWER/VS 
(regeneration or application of PTF s) 

• Condition of spooling devices 
and disk packs 

Check that the PTFs were applied 
correctly, and correct any other 
obvious errors in JECL or DOS/VS. 






\ 


No 






Check the following 

• Errors In JECL and device 
assignments 

• Condition of spooling devices 
and disk packs 

• The level of, and support for 
POWER/VS in the DOS/VS 
supervisor 

• Storage requirements and options 
specified in your version of 
POWER/VS 

Try to correct any errors. 








1 


' 






Determine if other programs are 
failing when run under the same 














version of POWER 
If so, contact the \ 
concerned, who m 
the reason already 
Proceed to check * 


/VS. 

programmers 
ay have isolated 
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Chart 01. Initial Environmental Checks (Part 2 of 3) 



Method of Analysis 



Recommendations for 
Further Problem Analysis 



-Check 4— — 

Eliminate 
components 
(Level 2) 



Was the failing job entered or output 
via terminal under POWER/VS RJE? 



Yes 



Submit job stream and data to the 
central station to be entered via 
local units. Request output to a 
local LST and/or PUN. It is 
advisable for you to supervise 
program execution at the central 
station to note system activity 
and avoid interruptions during job 
execution. 

Ensure the // OPTION DUMP 
statement is included in the job 
stream and request the control 
station to initiate SDAID dump 
on program check. After the 
input is spooled, issue the 
PDISPLAY ALL command to 
obtain the status of ALL queues. 
Issue this command again just 
before the output tasks are started. 
In severe cases of incorrect 
errors Q file and D file portions 
could be dumped selectively 
using the POWER/VS File 
Dump Program (see Debugging Hint 14) 

, If the malfunction recurs, 
proceed to check 5. 

, If the malfunction does not 
recur, suspect the RJE line 
used by the RDR input for 
the job stream. 
Go to check 6. 



If the error cannot be isolated by 

the previous general checks, rerun 

the job under POWER/VS with the 

SDAID dump on program check 

initiated. Also ensure that the 

// OPTION DUMP statement is 

included in the job stream. 

After the input has been spooled 

issue the PDISPLAY ALL command 

to obtain the status of all queues. 

Issue this command again just before 

the output (LST or PUN) tasks are 

started. 

In severe cases of incorrect 

errors, Q file and D file portions 

could be dumped selectively 

using the POWER/VS File 

Dump Program (see Debugging Hint 14) 

• If the nrialfunction recurs, 
proceed to check 5. 

, If the malfunction does not 
recur, no further analysis as 
to the cause of the original 
failure can be done. However, 
keep a record of the problem 
and its solution. 



^/ X 
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chart 01. Initial Environmental Checks (Part 3 of 3) 



Check 



Method of Analysis 



Recommendation for 
further problem analysis 



r,^^u R 










POWER /VS SCP 
error 


You may susspect the POWER/VS SCP 
of causing the error. 


Go to check 7 











1 Check 6 

RJE line or 
processing in 
error 


fc- 


You may susspect the RJE line used for 
job input or the processing of RJE 
under POWER/VS. 




To verify the line, re-run the job using 

a different RJE line(s) and where possible, 

different terminal devices on the line. 

If the malfunction recurs suspect 

POWER/VS RJE processing 

Proceed to check 7 

















-Check 7 

Catagorize the type 
of malfunction 




.VyAII.stjte_ . 


► 


Turn to chart 2 




LOOP 

J'!P2CrepLoy9'i^* 

Job/program canceled 


► 


Turn to chart 3 


Turn to chart 4 






Turn to chart 5 









( 
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Chart 02. Wait State, Part 1 of 9 



Check 



Method of Analysis 



\. J 



Recommendations for 
Further Problem Analysis 



— Check 1 — 

Check the 

information 

available 



An example and description of 
a formatted standalone dump 
is given in Appendix G of 
DOS/VS Serviceability Aids 
and Debugging Procedures. 



Use the list below to check the 
minimum amount of system 
information required: 

• SYSLOG log sheet 

• Note of PSW and low address 
storage bytes X'OO' - X'17' 

• Standalone dump (formatted)* 

• Line printer output from job(s) 

• User's POWER/VS generation 
listing 



If possible try to obtain any notes 
made by the user about the jobis) 
action and system activity prior to 
the malfunction. 

A SYSVIS dump may be necessary. 
Proceed to check 2. 



Check 2 -i 

Check messages 
and responses 




Examine the SYSLOG log sheet 
scanning for messages and operator 
responses. Check responses given 
with those recommended in 
DOS/VS messages. 




Look for unusual messages (those 
that do not obviously apply to jobs 
running may give you a clue). 
Any incorrect resporises will 
require a user rerun of the job(s). 
Proceed to check 3. 

















POWER/VS 
iaitialized 



Check that POWER/VS has been 
correctly initialized by checking 
for message 1Q12I 



Check DLBL. EXTENT, and LABEL 

information. 

If message 10121 has not been issued, 

go to Chart 06; otherwise, proceed 

to check 4. 



V. 
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Chart 02. Wait State, Part 2 of 9 



Check 



Method of Analygit 



Recommendetfons for 
Further Problem Artalytis 



. Ch«ck4 1 

Establish 
tasks started , 




Use SYSLOG log sheet to 
determine partitions and tatkt 
started under POWER/VS 
(this may help In further 
analysislL 




Make a note of the tasks and 
classes specified, as well as 
partitions and priorities. 
Proceed to check 5. 











( 



-r Check 5 1 

Locate all TCBs 
in the TSL 




Locate the POWER/VS wait 
control block in the stand- 
alone dump. (Refer to Table 
6.1 in this section, if you do 
not know how to do this) 

1 . Make a note of the address 
contained In bytes X'14' - 
X'17'intheWCB. (This 
will be a virtual address. 
Convert it to real by using 
the formatted list of page 
tables printed at the end 
of the standalone dump)* 

2. Locate this address in the 
dump. This is the first byte 
ofaTCBin4heTSL 

3. Make a note of the address 
contained in bytes X'14' - 
X'17'inthatTCB. and 
convert it to a real address. 

4. Repeat steps 2 and 3 until 
the address is that of the 
WCB. 




Proceed to check 6 to 
analyze each TCB whose 
address was noted in 
step 3 of this check 














* An example and description of a 
formatted standalone dump is 
given in Appendix G of DOS/VS 
Serviceability Aids and Debugging 
Procedures. 
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Chart 02. Wait State, Part 3 of 9 



Ch0ck 



- CiMck 6 — 
Determine 
task ID and 
type 



Method of Analysis 



Recommendations for 
Further Problem Analysis 






Examine by tet 4 through 7 

of each TCB addressed as 

noted in step 3 of check 5. 

. Byte 4 indicates the task ID: 

R = reader I 

W = writer J 

E = execution processor 
L = line manager ) 

= command processor > 

1 = initiator/terminator ) 
Any numeric character = RJE task < 
Bytes 5, 6 and 7 indicate the type 
of task: 

CP = command processor 
IT = initiator/terminator 
RLM = line manager 
ACT = saving or deleting 

account file 
TAT = status report 



Proceed to check 7 



Go to check 10 



Go to check 11 



Go to check 8 



Check 7 

Determine 
physical device 




Bytes X'9' - X'B' will contain 
the physical address of the 
device used as RDR, LST, or 
PUN. 




Go to check 11 













1 Check 8 1 

Establish 
line number 




Examine bytes X'9'- X'B' of 
the TCB. There will contain 
the line number. 




Proceed to check 9 













. Check 9 ^ 

Establish 




Examine bytes X'D' - X'F' of 
the TCB. These contain the 






remote ID 






Go to check 1 1 


of the line 




ID of the remote terminal that 

started the line. 

A code of X'FOFOFO' indicates 
















the line was started by the 








central operator. 
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Chart 02. Wait State, Part 4 of 9 



Check 



Method of Analysis 



Recommendations for 
Further Problem Analysis 



ChMk 10 

Establish 
partition 




The contents of bytes 6 and 7 
of the TCB will contain one of 
the following hex codes: 

• C2C7 = BG 

• C6F1 = F1 

• C6F2 = F2 

• C6F3 = F3 

• C6F4 = F4 




Locate R6 in TRSA of 

execution task TCB(s). 

This should address the 

associated partition control 

block(s). 

Proceed to check 10a. 











1 Check 10a > 

Analyze 
information 
in the PDB 




Examine the RDRdeviceentry, 

the LST device entries and the 

PUN device entries. 

(see Figure 5.23) 

From these obtain the addresses 

of the TCBs associated and the 

CCB addresses. 

Also note the partition COM REG 

address, the PI B address, device 

type codes (in the spool entries), 

and requestor IDs. 




Check CCB, TCB, PI Band 
COMREG addresses for validity 
and examine device type codes 
and requestor IDs. 
Make a note of any irregularities 
(this may be the cause of the error) 
and proceed to check 1 1 . 

















j Check 11 1 

Summary of 
reason for the wait. 




The wait state implies that a 
condition has occurred that 
has either not been satisfied 
or not been detected. 
When a POWER/VS event 
occurs it must be reported by: 

1 . The posting of the task 
ECB in the TCB, or the 
posting of any other ECB 
or CCB or the posting of 
an LK in a CB. 




The following checks 
guide you through a method 
• of analysis that will help you 
to locate the reason for the 
loss of one of these postings. 

Proceed to check 12. 


















2. The posting of the 
POWER/VSMECBin 
the CAT. 






3. Thepostingof the PIB 
entry belonging to the 
POWER/VS partition. 








Any code that is handling a 
condition must account for 
all three postings, or prove 
them not to be required. 
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Chart 02. Wait State, Part 5 of 9 



Check 



Method of Analysis 



Recommendations for 
Further Problem Analysis 



Establish ^ 
task state* 




Examine 
This will 


byteX'IC'oftheTCB. 








contain one of the 






following characters: 








l,P, 0, L ^ '* '^ "^ ** "^ "^ 


, r, ivi, \j., \^, o, u, n. 








Make a note of the character 








(the state) of each task. 








The list below summarizes the 








meaning of each state: 








(C9) 1 


= task inactive 








(D7) P 


= page fault in process 








(D6) 


= waiting for operator 
response 








(D3) L 


= waiting for locked 
resource 








(C6) F 


= waiting for LTA 








(D4) M 


= waiting for multiple 
CCB or ECB posting 








(D8) Q 


= as for M, but event 
may never occur 








(C3) C 


= waiting for single 
CCB or ECB posting 








(E2) S 


= as for C, but event 
may never occur 








(C4) D 


= dispatchable 








(D9) R 


= running 












f 


Yes 








1 






Is there a task in the R state. L 




Indicates that POWER/VS 










1 




had control of system at 
time of malfunction. 


















Go to check 13, 






No 














Indicates that the POWER/VS 
partition is in the wait state 


* Details of the various 








task states are given in 








Sections 2 and 3. 






Proceed to check 1 5. 


It is advisable to 















familiarize yourself 
with 'task state 
processing'. 
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chart 02, Wait State, Part 6 of 9 



Method of Analysis 



Recommendations for 
Further Problem Analysis 



j Check 13 ^ 

Task in 
R state 




Examine the contents of the 
registers in the TRSA in the TCB. 




The values in the registerf 
record their contents when 
the task was given control. 
Register conventions 
are described in 
Section 3. 

Examine the register saved 
in the POWER /VS partition 
save area and the return PSW.* 




















The address in this PSW will 
point to an instruction in 
the routine which will get 
control next. 










Proceed to check 14. 



Refer to DOS/VS Serviceability 
Aids and Debugging Procedures 
for details about the partition 
save area. 



Check 14 

Analyze task 
in R state 




Examine the PIB entry 
forthePOWER/VS 
partition. Byte 
shpuld be X'83'. 

Examine partition save 
areaof POWER/VS 
partition; Rl may point 
toCCBorECB. 


^ 


This is probably a DOS/VS error 
not caused by POWER/VS. 
However, check that the POWER/VS 
code has not been changed by the 
user, since this error indicates that 
an.SVC 7 was issued by the POWER/VS 
task rather than by task management. 

1 f the cause of the wait state does 
not seem to be this task proceed 
to check 15. 
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Chart 02, Wait State, Part 7 of 9 

Ched( Method of A nalysis 



Recommendations for 
Further Problem Analysis 



\^ 



Check 15 , 




This Indicates that the POWER/VS 
partition is in the wait state. 




Examine other fields In the TMS in 
each TCB and the registers In the 






Task(8) not 
in 'R' state. 




Locate the instruction before the 




TRSA in each TCB 




Instruction address contained in 




. R 1 2 points to the instruction 




the return PSW in the partition 




which would have been executed 






save area. If this Instruction is 




after the IPW$WFx macro was 






0A07 It means that an SVC 7 has 




handled. Cross check this with 






been Issued to OOS/VS. Examine 
byte of each RIB entry to confirm 




the contents In R9 and/or 1 5 
which will point to the start 








the wait state. The reason for this 




of that CSECT. From the 




must be isolated by first analyzing 




SYSVIS dump you can determine 




information contained in each TCB. 




the routine or the CSECT of the 




caller, (see debugging hint 




number 8) (If no SYSVIS dump 




is available, the address in R 12 




will have to be converted to 




real (see Appendix E) to 




enable the standalone dump to 




be used.) 




R13 may point to an LRSA. 




Depending on the task, the 




registers saved may give a clue 




to the error. 




. Rl points toa CCBor ECB if the 




task was In 'C or 'S' state, or to 




a list of several addresses of CCBs 




or ECBs if the task was in 'M' or 




'Q' state. 




Go to check 16. 




. R3 points to a CB using a resource 




if the task was in 'L' state. 




Go to check 17. 




. Examine R 13 in the TRSA. If it 




addresses the LRSA in the TCB and 




there is a second LRSA outside the 




TCB, the task was executing code 




in a physical routine. If it addresses 




an LRSA outside the TCB, the task 




was executing code in a logical 




routine. This Is not true for an 




execution processor task which 




has only one LRSA in the TCB. 




(Refer to Figure 5.13) 




If the task was executing code in 




a physical routine (determined 




from step 1), a field (X'80' - X'FB') 




in the TCB may have been initiated 




(depending on how much of the 




physical routine had been 




executed prior to the wait), which 




will enable a check to be made on 




addresses for the QR and LDA 




and data records. (See Figure 5.17) 




. Fortasksin'l','F','P', 'O'or'D' 










state, go to check 18. 



\^.y 



1 



y 
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chart 02. Wait State, Part 8 of 9 



Check 



Method of Analysis 



Recommendations for 
Further Problem Analysis 



Check 16 


















Task in C, S. 




















C or S state implies that 






Examine bit 16 in the 








^ 


M or Q state 






the related task is waiting 
for posting of the traffic 








conventional CCB or the 














"'A/ERVS ECB addressed 








bit (hit 16) within the 








by Rl in the TRSA in the 








control block addressed 








; CB. If bit 16 = 0, the CCB/ECB* 








by register 1 of the task in question. 








is !!Ot posted and the 

' vstem may be in a wait 




















i caused by a lost I/O interrupt. 






M or Q state implies that the 






\ Examine CCBs in user 








related task is waiting for 








partition running under 








the posting of the traffic 








POWER /VS. These CCBs 








bit (bit 16) within any one 








will be addressed by Rl in 








of a set of control blocks. 






-i the relevant PSAs. 








The addresses of the relevant 






A branch should have been 








control blocks are contained 






made to the task scan routine 








in a seciuential list addressee] 






to examine the next TCB in 








by register 1 of the waiting 






the TSL. If bit 16 = 1, the 








task and delimited by the 






task should have been dispatched. 








value X'FF' in the byte 
fpllowinc) the list. 




1 


















Examine bit 16 in all CCBs or 






■~ 
























ECBs addressed from the address 








list pointed to by Rl in the TRSA 








in the TCB. (ECBs may be in 








the TCCT field of the TCB, thus 








allowing classes to be checked; 








from the MCTA, QRs can be 








cross checked with the OR, see 








check 19.)* 








If bit 16 = 1 in any of the CCBs 








or ECBs, the tusk should have been 




* Refer to Appendix 




dispatched. 




F for a summary of 




If bit 16 = 0, examine the next 




ECB usage. 




CCB or ECB addressed by the 
address list If they are all the 
cause of the wait may be a lost I/O 
interrupt. 

Examine CCBs in user partition 
running under POWER/ VS. These 
CCBs will be addressed by Rl in 
the relevant PSAs. Refer to 
DOS/VS Serviceability Aids and 
Debugging Procedures, Section 4 
Pafrt 1. 
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Chart 02. Wait State, Part 9 of 9 



Method of Analysis 






Recommendations for 
Further Problem Analysis 



Check 17 










Task in 
L state 




L state implies that 
the related task is - 


^ 


Examine the LK in the CB 

addressed by R3 in the 










waiting for a resource 
which is presently 




TRSA in theTCB. 

If the resource required by 








locked against 




this task is in use by another 




concurrent use. The 




task, byte of the LK in a 




resource concerned 




CB will beX'FF'and bytes 




is addressed by register 




1-3of the LK will address 




3 of the waiting task. 




the TCB being used by the 
task using the resource. 






(It does not imply an error 




if you find several tasks 




waiting for the same resource.) 




Look for an interlock of 




resources where two tasks are 




each waiting for a resource 










owned by the other. 







Task in l,F, 
P, 0,or D state 




•, For task (s) in 1 state: 

Check if the task is supposed 








to be inactive. 
• For task (s) in F state: 








Task is waiting for the LTA. 




(testing field TRTLTK (in 




the DOS/VS supervisor) for 




nonzero) 




• For task (s) in P state: 




Task is page bound. 




, For task(s) in state: 




Check SYSLOG output 




for correct responses to 




messages. 




• For task(s) in D state: 




Check state of other tasks. 




(may be error in task 






selection) 



K..y 



\_a' 
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Chart 03. LOOP, Part 1 of 2 



Method of Analyses 



Recommendations for 
Furtfier Problem Analysis 



j Check 1 1 

Chock the 

information 

available 




Use the list below to check 
the minimum amount of 
system mformation re(|uired: 

• SYSLOG loc) sheet 

• Note of PSWancI low 
address storage bytes 




If possible try to obtain any notes 
made by the user about the job(s) 
action and system activity prior to 
the malfunction. 
A SYSVISdumpmay be necessary. 












X;00' X'17' 

• Standalone dunip 

(formatted)* 




Proceed to check 2. 










• Line printer output from 






)ob(s) 






• User's POWER, VS 






generation listing 








• Trace of the loop. 







An example onci description of 
a formatted standalone dump 
is given in Appendix G of 
DOS/VS Serviceability Aids 
and Debuggint) Procedures. 



— Check 2 — 

Check 
messages 
and responses 



Examine the SYSLOG log sheei 
scanning for messages anci 
operator responses. Check 
responses given with those 
recommended in DOS/VS 
messages. 



Look for unusual messages (those 
that do not obviously apply to 
jobs running may give you a clue). 
Any incorrect responses will 
require a user reruaof the job(s). 
Proceed to check 3. 



Check 3 

POWER/VS 
initialized 




Check that ^OWE R/VS has been 
correctly initialized by checking 
for message 1Q12I. 




Check DLBL, EXTENT, and LABEL 

information. 

If ipnessage 1Q12I has not been 

issued, go to Chart 06; otherwise, 

proceed to check 4. 
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chart 03* LOOP, Part 2 of 2 






Method of Analysis 



Recommendations for 
Further Problem Analysis 



Trace path 
of loop. 







Use the ioop trace provided 
by th<? ussr and tha dump to 




If the trace is not sufficient 
(not enough Instruction addresses 












locate the path ct the loop. 




noted), it may meah that the loop 






It may be a short loop in one 
CSECT or one routine. 




goes across one or more CSECTs 
or even between partitions 








Use the listings of that CSECT 




(including the DOS/VS supervisor). 




or routine and the dump to 




In this case there are two methods 




check instructions executed. 




of analysis open: 

1. Rerun the job with an SDAID 










and /or PDAID* trace. 






Note, however, that an SDAID 






trace is only useful to trace 




* SDAID and PDAI Dare 
described in DOS/VS 
Serviceability Aids and 
Debugging Procedures. 


code in the nucleus and/or 
code in a CSECT in the 
pageable area. Since tables 
and control blocks in the 
fixable area are dynamically 
allocated, there is no point 
in including this area in the 
SDAID trace. 
2. If you consider that information 
available is sufficient, analyze 
the dump in an attempt to 
gather system information as 
indicated in Chart 02 (wait 
state) beginning at check 4 










(ignore check 11). 



J Check 5 , 

CSECT logic 




Check the logic flow of the 




Cross check these counters 




CSECT(s) within the path of 




(ECBs, CCBs) in the dump 


flow analysis 




the loop for: 

. Count locations that can never reach 
their limits. 




for validity (not overwritten). 












. Counters that are not updated 








. Counters that are never initiated 








Count locations, the contents of which 








are not periodically or properly tested 








Check that I/O operations are able to 








reach their completion (CCBs posted) 








Check ECB postings (Refer to 








appendix F). 
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Chart 04. Incorrect Output 



Method of Analysis 



Recommendations for 
Further Problem Analysis 



, Check 1 1 

Check the 

information 

available 




Use the ifst below to check the 
mininnum amount of system 
information required: 

• SYSLOG log sheet 

• System dump or KILL dump 

• SDAID (lump (if one executed) 

• Line printer output from job(s) 

• User's POWER/VS generation 
listing. 




If possible try to obtain any notes made 
by the user aliout the job(s) action and 
system activity prior to the malfunction. 
Gather as much information as possible 
about the system environment, history 
of the program (s) used, and input files. 
(Incorrect input to the program generating 
the incorrect output may be the cause of 
the error.) 
Proceed to check 2. 

















An example and description of a 
formatted standalone dump is 
given in Appendix G of DOS/VS 
Serviceability Aids and Debuggmg 
Procedures. 



c 



j Check 2 1 

Check 

messages and 
responses 




Examine the SYSLOG log sheet 
scanning for messages and operator 
responses. Check responses given 
with those recommended in DOS/VS 
Messages 




Look for unusual messages (those that 

do not obviously apply to jobs running 

may give you a clue). 

Any incorrect responses will require a 

user rerun of the job(s). 

Proceed to check 3. 

















Check 3 1 

Gather file 
information 




Rerun the job with output disposition 'K' 
for the output that fails. 




Dump the queue and data files belonging 
to the failing job, using the PQWER/VS 
file dump program (see debugging hint 
number 14). 
Proceed to check 4. 

























Analyze dump 




Check the contents of the queue 




If no discrepancies can be found. 


of queue and 




record (s) and data record (s) 




suspect the writer task. 


data files 




belonging to the failing job for: 

loss of data 
. duplicate data 




If errors are found. 








suspect the execution writer task. 
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Chart 05, Program Check, Part 1 of 2 



Ch0ek 



Method of Analysii 



R9Comnmnd§tiom for 
Furthor Problem Analytii 






Check the 

information 

available 




Use the list below to check the 
minimum amount of system 
information required: 

. SYSLOG log sheet 

System dump or K 1 L L dump 
SDAID dump (if one executed) 
Line printer output from iob(s) 

. User's POWER/VS generation 
listing. 




If possible try to obtain any notes made 
by the user about the job(s) action and 
system activity prior to the malfunction. 

Proceed to check 2. 

















An example and description of a 
formatted standalone dump is 
given in Appendix G of DOS/VS 
Serviceability Aids and Debugging 
Procedures. 



■ChMk2- 



Check mejisages 
and responses 



Examine the SYSLOG log sheet 
scanning for messages and operator 
responses. Check responses given 
with those recommended in DOS/VS 

mess«^®s. 



Look for unusual messages (those that 
do not obviously apply to jobs running 
may give you a clue). 
Any incorrect responses wilt require a 
user rerun of the job(s) . 

Proceed to check 3. 



.J^- 



— Checks — 

POWER/VS 
initialized 



Check that POWER/VS has been 
correctly initialized by checking for 
message 1Q12I. 



Check DLBL, EXTENT, and LABEL 

information. 

If message 1012I has not been issued 

go to Chart 06, otherwise proceed to 

check 4. 



4' ' 
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chart 05, Program Cheeky Part 2 of 2 



Method of Analysis 



Recommendations for 
Further Problem Analysis 



Establish 
tasks started 




Use SYSLOG log sheet to 
determine partitions and 
tasks started under 
POWER/VS. (This may 
help in further analysis). 




Make a note of the tasks 
and classes specified, as well 
as partitions and priorities. 
Proceed to check 5. 











Check 5 
Analyze 
Dump 




Locate the TCB in 'R' state. 
If ydu do not know how to do this, 
carry out the instructions in checks 
5 and 1 2 of Chart 02 (wait state). 




The program check is probably in the 
task owning this TCB, To identify the 
task, carry out the instructions in 
check 6 of Chart 02 (wait state). 
Use the program check message and 
analyze the dump as described in 
Section 4. Part 1 of DOS/VS 
Serviceability Aids and Debugging 
Procedures. 

If the program check address is at 
a displacement of 2 from the 
beginning of a module, proceed 
to check 6. 

















C^ ^ 



Checks 

Establish 
module name 




Analyze the dump in which no 

pertinent information has been 

destroyed. 

Check the code where the branch 

was taken. 




The program check was probably 
forced because a POWER/VS logic 
error was detected. This is only 
valid for modules IPW$$IB and 
IPW$$OB. 
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chart 06. POWER/VS not Initialized, Part 1 of 2 



k_^' 



Method of Analysis 



Recommendations for 
Further Problem Analysis 



Check 1 -— — 

Is the WCB 
present in 
the dump. 




Locate the POWER/VS wait control 
block in the standalone dump, 
(Refer to Table 6.1 in this section 
if you do not .know how to do this.) 




If neither the WCB nor CAT 
appear to be in the dump, go to 
check 8; otherwise, proceed to 
check 2. 











Is initiator 
TCB attached. 




1. Mak§ a note of the address 
contained in bytes X'14' - X'1 7' 
in the WCB. (This will be a 
virtual address. Convert it to 
real by using the formatted list 
of page tables printed at the end 
of the standalone dump.*) 

2. Locate this address in the dump. 
This is the first byte of the 
initiator TQB. 




Examine byte X'lC of TCB. It 
should contain X'C9' (1). If not, 
it may contain one of the 
following hex codes: 

• C3(C), go to check 5 

• D9(R), proceed to check 3 

• D7(P), suspect the DOS/VS 

page manager routines. 

















An example and description 
of a formatted standalone 
dump is given in Appendix G 
of DOS/VS Serviceability Aids 
and Debugging Procedures. 



- — — Checks 

Task in 
R state 




Examine the contents of the registers 
in the TRSA in the TCB. 




The values In the registers record their 

contents when the task was given 

control. 

Register conventions are 

described In Section 3. 

Examine the register saved in the 

POWEft/VS partition save area and 

the return PSW.* The address In this 

PSW will point to the next instruction 

to be executed. 

Proceed to check 4. 

















w 



Refer to DOS/VS Serviceability 
Aids and Debugging Procedures 
for details about the partition 
save area. 



-^" Check 4 

Analyze task 
in R state 




Examine the PIB entry for the 

POWER/VS partition. Byte should 

beX'83'. 

Examine partition save area of 

POWER/VS partition; R1 may point 

to CCB or ECB. 




This is probably a DOS/VS error not 
caused by POWE R/VS. However, check 
that the POWE R/VS code has not beeh 
changed by the user, since this error 
indicates that an SVC 7 was issued by 
the POWER/VS task rather than by 
task management. 

If the cause of the wait state cannot be 
isolated, proceed to check 6. 
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Chart 06. POWER/VS not Initialized, Part 2 of 2 



Check 



Method of Analysis 



Recommendations for 
Further Problem Analysis 



J Check 5 1 

Task in >. 
C state 




C state implies that the related 
task is waiting for posting of the 
traffic bit (bit 16) within the control 
block addressed by register 1 of the 
task in question. 




Examine bit 16 in the conventional COB or 
the POWER/VS ECB addressed by Rl in 
the TRSA in the TCB. 
If bit 16 = 0, the CCB is not posted and 
the system may be in a wait caused by a 
lost I/O interrupt. Examine CCBs in user 
partitions running under POWER/VS. 
These CCBs will be addressed by Rl in the 
relevant PSAs. 

A branch should have been made to the task 
scan routine to examine the next TCB in 
theTSL. If bit 16= 1, the task should 
have been dispatched. 

















. Check 6 > 

Check tables 
setup by 12 








"~" 




If fields are not initialized correctly, 
proceed to check 7, 




in the module load address part 

nf thP nAT (qpp Finiirp R A\ 












Check them and all relocatable 
constants for correct initiation. 










2. Examine the SCB, which should 
be completely initialized. 
(See Figure 5.6) 




If not initialized, cause of error may 
bePFIX routine. 
















3. Examine the MMB and 

check initialization of the 
channel program. (CCWs 
should point to an area within 
theCB.) 










4. Check if there is a temporary 
operator command processor 
TCB chained in the TSL. 




If there is a temporary OCPR in the 
f ixabte area, the dump was executed 
during the IPW$ICP macro routine. 



















j Check 7 

12 loaded 
correctly 




Examine registers 8 and 9 in the PSA 
of the POWER/VS partition. 




If they are initialized as base registers for 

12, compare the listings of 12 with the 

code in the dump. 

If all appear correct, check if the listing 

is at correct level and has not been changed 

by the user. 

If there appear to be discrepancies, 

proceed to check 8. 

















- Check 8 - 

II loaded. 



Look for the phase II and the GNB. 
If 1 1 has been loaded correctly, the 
GNB will immediately follow the 
label area in the POWER/VS partition 
at X'140'. The phase II should be 
loaded immediately after the GNB. 



Check data in the GNB against the 

POWER/VS generation listing supplied 
by the user. 

Check the listing to see that 11 is at 
correct level and has not been changed 
by user. 
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Appendix A. Abbreviations 



j Abbreviation j Meaning 



|AARA j Auxiliary account record area 

|ACB [Account control block 

]ACB I Access method control block 

|AQ I Add to queue 

|AQRA I Auxiliary queue record area 

I AS I Asynchronous service 

|ASAB I Asynchronous service anchor block 

Jaws | Account work space 

|BCA [Buffer control area 

|BCW 1 Buffer control word 

I CAT I Control address table 

I CB I Control block 

|CCB [Command control block 

I CP I Command processor 

]CPB I Command processor control block 

JDLRSA j Double linkage register save area 

1 DMB JDisk management block 

|DQ ] Delete from queue 

JDRW [Disk request word 

I EAR j Execution account record 

I ECB (Event control block 

|ER 13540 Diskette reader 

|ETX jEnd of text 

|FCB I Forms control buffer 

1 FQ I Free queue 

jGD I Get data record 

j GNB I Generation table 

jiB JSNA inbound processor 

I IC jPass command routine 

jICR (Internal reader 

I INIT/TERM I Initiator/Terminator 

JJECL [Job entry control language 

I LCB I Line control block 

ILDA j Logical data record area 

|LF ISNA logoff processor 

I LK j Lockword 

I LL ] Logical list 

]LMF [Line manager field 

JLMGR I Line manager 

I LN I SNA logon processor 

I LP j Logical punch 

|LR j Logical reader 

I LRSA ] Linkage register save area 

ILST [List 

|LTA j Logical transient area in the DOS/VS supervisor 

|LU jLUB/PUB update 

|LW [Logical writer 

jMCB [Module control block 

JMCTA j Master class table area 

|MECB [Master (main) event control block 

|MLT ] Master line table 

[MMB ] Message control block 

I MP [SNA message processor 

[MR [Master record 

|MRA [Master record area 

[MS [Message handler 

[MS j Message service in nucleus 

[MSCB [SNA message control block 



-H 
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I Abbreviation 
Y + 

JNQ 

I OB 

|0E 

|0T 

I PA 

|PD 

|PDB 

IPCB 

I PDA 

I PL 

|PP 

I PR 

IPS 

I PSA 

I PUN 

JPWS 

IQRA 

IQS 

|RCF 

|RDR 

|RE 

IRJE 

|RM 

|RMCB 

|RPL 

IRQ 

IRTAM 

ISA 

ISAM 

|SC 

|SCB 

I SDA 

|SKAD 

|SL 

I SLA 

|SLW 

|SM 

|SN 

I SNCB 

|SPL 

JSPM 

I SRB 

I SUCB 

|TBB 

ITCB 

|TM 

|TMF 

ITMS 

I TR 

ITRSA 

|TSL 

|VS 

I VTAM 

I WACB 

1 WCB 

|WTR 

IXJ 

IXL 

|XP 

JXR 

|XW 



Meaning 



I Get next from queue 

I SNA outbound processor 

I Open 35«40 diskette reader 

jopen tape routine 

I Put account record 

I Put data record 

[Partition control block 

J Page ccmtrol block 

I Physical data record area 

I Physical list 

I Physical punch 

I Physical reader 

I Print status report 

I Partition save area 

I Punch 

j Physical work space 

I Queue record area 

1 Queue set 

I Record control field 

I Reader 

I User reader exit routine 

I Remote job entry 

j Resource management routine in nucleus 

I SNA remote control block 

[Request parameter list 

I Reserve queue record 

1 Remote terminal access method 

I Save account 

Isequential access method 

I Scan reader JECL statement 

[Storage control block 

1 Single data adapter 

I Seek address 

I Get SSL record 

j Separator line area 

I SLI work space 

] Storage management service in nucleus 

I SNA manager 

I SNA control block 

I Spool parameter list 

[Spool management 

I Service request block 

i SNA unit control block 

[Tape control block 

jTask control block 

I Remote job entry routines 

[Task management field 

[Task management service 

I Task terminator 

I Task register save area 

|Task selection list 

[Validation service in nucleus 

I Virtual telecommunications access method 

]SNA work space 

[Wait control block 

[Writer 

I Scan execution JECL statement 

[Execution list 

j Execution punch 

[Execution reader 

[Execution writer 



H ^ 
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Appendix B. POWER/VS Organization of Libraries 
and PTF Application 



Type of PTF 



Object deck 
of complete 
IPW$$ phase 



Shipped generation 
table (with default 
options) phasename 
POWER listing 



1 
I 
I 
I 



REP card(s) for 
IPW$$XX phase 



Macro update 
card(s) 



Punch corresponding 
phase from CILby 
CSERV and put REP 
card in 



. on microfiche 



• Program listings 

I on microfiche only 
I ^ - ^ - . 



Catalog new phase 
IPW$$XX toCIL 



'^ '^ 



-.^v^ 



r* 

I 



User generation table 
on user assembly 
listing 



1- 



CIL 



SSL 




Update macro on 
SSL by MAI NT 



To generate POWER 
version with other 
thandefault options 
assemble POWER 
macro (for RJE 
.alsoPLINE,PRMT,. 
PCPTAB) I 



1 

Macro listings on | 
microfiche and i 
SSERV displays . 



Object deck of 
"GENTAB phase" 




Catalog "GENTAB 
phase" to CI L. 
( IPW$$XX phases 
are not LNKEDT 
here) 
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Appendix C. POWER/VS Status Bytes in the DOS/VS Supervisor 



SYSCOM* 



Location X'5C' - X'SF* contains the address of the POWER/VS partition {label IPW$PDA in 
phase IPW$$NU) , if POWER/VS is initiated. 

Location X' 42* contains a flag byte: 

X'08' = POWER/VS supported 
X'04' = POWER/VS initialized 

L ocation X*B8* contains the address of resource table (PIB translate masks) in DOS/VS 
supervisor. 

PARTITION COMREGS* 



Location X' AO' - X'A3* contains the address of the partition control block (0 if no CB 
exists for this partition). 

POWER/VS Flag Bytes 

Location X'A4' contains POWER/VS flags: 

X'80' = POWER/VS accounting support 

X'UO' = This partition under control of POWER/VS 

X'20' = This partition is the POWER/VS partition 

* Refer to DOS/VS Serviceability Aids and Debugging Procedures for a full description 
and locations of SYSCOM and the partition CGMREGs. 

Location X*A5' 



Not used. 






■k... 
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Appendix D. Summary of ECB Usage 



( 



ECB in: 



ACB 
CAT 



Posted by: 
(Phase) 

IPW$$GA 
Appendage 



SCB 

DMB 

TCB (CP) 

TCB (LMGR) 



TCB (LST) 
TCB (OB) 



TCB (PUN) 
TCB (RDR) 
TCB (SN) 



TCB (SN) 

TCB (XP) 

TCP (XW) 

TCB 
INIT/TERM 

SRB 
ASAB 






Release work space 

IPW$$FQ 

IPW$$I2 

• Channel end appendage 

• When line is started 

• When line is stopped 

IPW$$IB,, lPW$$]yiP, 

IPW$$SN 



VTAM (at completion of 
a RECEIVE ANY) 

IPW$$SN„ IPW$$LN, 

IPW$$IB,, IPW$$OB, 

IPW$$MP^ IPW$$LF 

IPW$$VE,, IPW$$LH,, 

IPW$$MS 

SVC appendage 

Doiible buffering posting 

IPW$$I2 

IPW$$CP 



IPW$$AS (SUBTASK) 
IPW$$AS 



Unposted by: 
(Phase) 



IPW$$PA 

Task 

selection 

mechanism 

Reserve work 

space 

IPW$$RQ and 

IPW$$PD 

IPW$$CP 

Line manager 
every time it 
is selected 

IPW$$OB 



IPW$$SN 



IPW$$SN 



IPW$$XP 
IPW$$PD 
IPW$$I2 



Task offer 
posting 
IPW$$AS 
(SUBTASK) 



Use when posted: 



Indicates account file is emptied. 
Indicates work to be done for 
POWER/VS, 

Indicates that work space is 

available. 

Indicates that queue space is 

available. 

Indicates that IPW$$I2 has sent 

information to IPW$$CP. 

Indicates work to be done for line 
manager. 

Indicates that RJE„SNA transmission 
to SNA terminal previously suspende i 
is to continue. 

Not used. 

(VTAM ECB) indicates that the SNA 
manager (IPW$$SN) has to attach the 
SNA inbound processor (IPW$$IB) . 
(Work ECB) indicates work to be done 
for the SNA manager (IP$$SN). 



Indicates work to be done for 

the execution processor. 

Disk control block freed and (if 

write operation) data area freed. 

Normally indicates that IPW$$CP 

has finished a task. In case of 

AUTOSTART indicates that information 

from IPW$$I2 has been received and 

processed by IPW$$CP. 

Indicates that the service request 

has been processed. 

Indicates that one or more service 

requests are waiting to be processed. 



Note : An entry in the master class table area can be used as an ECB* In that case the 
address of the entry is contained in the task class list (ECB list) in the TCB. When the 
ECBs in the RDR^ LST, or PUN class are posted (by IPW$$AQ)„ they indicate that an active 
entry exists in the class chain represented by this class table entry. These ECBs are 
unposted by IPW$$NQ. 
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For example, assume a TCB for a LST task in the queue state: 



%. y 









/ 


• 1 


1 1 


II 


\.r 1 





TCB 



Task Class List* 




^^^^^^^^^^^^^^^^^^^^^^^ 



J 1 1 inin,,,,,,,,,, I I , 



The task class list may contain 
up to four entries. The 
delimiter (X'FF') always 
follows the last entry. 



Reader class area 



List class area 



Punch class area 



V y 



Master Class 
Table Area 
(See figure 5.8) 



0003 



If bit 16 -= 1 (posted): dispatch task 



record number 1 is the last 
queue set in this class, 
record number 3 is the first 
queue set in this class (A). 
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Appendix E. POWER/VS Status Report 



. V 



C 



STATUS REPORT FORMAT 



This report is printed on two occasions: 

1. When POWER/VS is initiated,^ when SYSLST is assigned to a line printer on the POWER/VS 
partition. 

2. When POWER/VS is terminated with a PEND coinmand that includes a physical address of a 
line printer,. 

The format is shown below: 

POWER/VS STATUS REPORT date time 

QUEUE FILE IJQFILE 

Total number of queue entries xxxx 

Number of free queue entries xxxx 

Maximum number of queue entries used in last session xxxx 

DATA FILE IJDFILE 

I . Total number of tracks xxxx 

Track group size xx 

Data block size xx 

ACCOUNT FILE IJAFILE 

Total number of tracks xxxx 

Percentage of file that is filled xx % 

Real storage allocated to POWER/VS partition xx pages 

Number of times tasks were waiting for real storage xxx 

Maximum number of real pages used xx pages 

Maximum number of tasks active at one point in time xx 

If POWER/VS is initiated via a warm start a PDISPLAY ALL,, cuu command is issued by the 
initiator task. (In addition to this status report) on the printer assigned to SYSLST 
(cuu) . 

A PDISPLAY ALL^cuu is also executed when a PEND cuu command is issued by the terminator 
task. 
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Glossary 



account file; The P0WER/7S account file is 
a direct access file maintained by POWER/VS 
to hold the accounting information 
generated by POWER/VS and the programs 
which it controls, 

ap pe ndage^routine ; a set of code 
physically located in the POWER/VS nucleus 
but logically an extension of a DOS/VS 
supervisor routine* 

AUTOSTART: A facility used to specify that 
a POWER/VS system is to be started 
automatically when it is initialized. 

class: A means of grouping jobs that 
require the same set of resources for their 
execution. There are two types of class: 
input class and output class. 

cold start; The initialization of input 
and output work queues. All information 
present in the queues before the cold start 
is lost. 

data file: The POWER/VS data file is a 
direct access file maintained by the 
POWER/VS system to hold the input and 
output program data records required and 
generated by DOS/VS programs under POWER/VS 
control. The file may occupy from one to 
five extents of direct access storage 
according to the user's requirements. The 
total space provided by the user is divided 
into units called track groups. 

disk request word: see I/O request word. 

external routine; a set of code physically 
located in the POWER/VS pageable area, 
which provides task support external to the 
POWER/VS nucleus. Physical readers and 
physical writers are examples of external 
routines. 

flushing: Flushing is used to discontinue 
a job that is being processed by a POWER/VS 
task. Processing continues with the next 
entry in the read queue. 

function routine: a set of code within 
POWER/VS which performs high-level 
operations on POWER/VS files. 

intermediate _storac[e ; A storage device 
(disk or tape) used in POWER/VS to which 
the information from the card reader is 
spooled before execution, or from which the 
information is spooled to the printer or 
punch after execution. 

internal routine: a set of code physically 
located in the POWER/VS pageable area. 



which provides task support internal to the 
POWER/VS nucleus. Logical readers and 
logical writers are examples of internal 
routines. 

I/O request word; An I/O request word is 
sixteen bytes of fixed storage (TCB) used 
to define a disk or tape input or output 
operation to the disk or tape service 
routines. 

job entrYl,control__lanqaage; A control 
language which allows the programmer to 
specify how POWER/VS is to handle a 
particular job entry. Abbreviated JECL. 

lockword: A lockword is a fullword of 
fixed storage associated with a specific 
resource and used by the Resource 
Management mechanisms to control task 
access to the resource. 

ma ster record; The first record within the 
POWER/VS queue file. It describes the free 
queue set within the POWER/VS system and 
hence provides the system with a warm start 
capability. 

multitasking; concurrent execution of one 
or more subtasks attached to a main task 
within one partition. 

page fault: A program interruption that 
occurs when a page that is marked "not in 
real storage" is referred to by an inactive 
page. Synonymous with page translation 
exception. 

POWER/VS operator ,c;Qmmand_language: An 
operator language used by POWER/VS to 
present operator commands. Abbreviated 
POCL. 

priority; A rank assigned to each job 
within its class that determines its 
precedence in receiving system resources. 

queue: A waiting line or list formed by 
items in a system waiting for service. 

queue entry; A queue entry is a single 
direct access record describing one 
particular job element to the POWER/VS 
system; it is used to record the progress 
of that job element through the system. A 
queue entry contains a queue set together 
with its associated track groups. 

queue file; The POWER/VS queue file is a 
direct access file maintained by the 
POWER/VS system to record the passage of 
user jobs through the system. The size of 
the queue file determines the number of 
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jobs which POWElR/VS can handle 
concurrently. A maximum of 102 U jobs is 
presently imposed on the system by 
programming. 

aH§H^-£§£2£5 • A record on the queue file 
containing the address of a track group on 
the data file. The queue records which 
contain the addresses of the track groups 
for one input job stream form a queue set. 

queue set: One or more direct access 
records (queue records) describing one 
particular job element to POWER/VS. It is 
used to record the progress of that job 
element through POWER/ VS. 

reenterable code ; a routine or other set 
of instructions of which the same copy can 
be used concurrently by more than one task. 

remote _ job entry ; Submission of job 
control statements and data from a remote 
terminal, causing the jobs described to be 
scheduled and executed as though 
encountered in the input stream. 
Abbreviated RJE. 

remote terminal; An input/output control 
unit ^nd one or more input/output devices 
attached to a system through a transmission 
control unit. 

resource: A resource (more properly 

"serial resource") is any code, control 

block, table, record, or file used by a 
task. 

resource management: Resource management 
consists of the mechanisms that protect 
serial resources from concurrent access by 
competing tasks . 

segmentation; A facility to break bulky 
list or punch output into segments so that 
printing or punching can be started before 
execution of the generating user program 
has been completed. 

service routine : a set of code whithin 
POWER/VS which performs low-level 
operations (task scheduling, storage 
control, etc. ) . 

spooling; The reading of input data 
streams and the writing of output data 



streams on auxiliary storage devices, 
concurrently with job execution, in a 
format convenient for later processing or 
output operations. 

staging: The moving of data from an 
offline or low-priority device back to an 
online or high-priority device, usually on 
demand of the system or on request of the 
user. 

storage descriptor; Storage Descriptors 
are sixteen-byte alphameric character 
strings which serve to identify important 
areas in a storage dump. Where 
appropriate, storage descriptors may also 
be used for programming purposes. 

storage line: A storage line is a unit of 
program address space of 32 bytes and is 
aligned on a 32-byte boundary. 

storage .page; A storage page is a unit of 
program address space of 2048 bytes and is 
aligned on a 2048-bytes boundary. 

tape request word ; see I/O request word. 

task: A task is the basic unit of 
synchronous program execution within the 
POWER/VS system. A task consists of 
instructions operating synchronously upon 
program data. Though a task is executed 
synchronously with respect to its own 
instructions, these are executed 
asynchronously with respect to all other 
tasks existing in the system. 

task management: Task management consists 
of the mechanisms that allocate control of 
the central processor to the POWER/VS tasks 
that are competing for its use. 

track group; The track group is the basic 
organizational unit of the data file. Each 
track group consists of an integral number 
of tracks; the track group size is 
calculated by POWER/VS at initialization 
time on the basis of the amount of direct 
access storage space provided by the user. 
This value may be overridden by the user 
should he wish to do so. 

warm start; A restart that allows reuse of 
previously initialized input and output 
work queues. 
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